Fungsi SetNtmsObjectSecurity (ntmsapi.h)

  • Artikel

[Manajer Penyimpanan yang Dapat Dilepas tidak lagi tersedia pada Windows 7 dan Windows Server 2008 R2.]

Fungsi SetNtmsObjectSecurity menulis deskriptor keamanan untuk objek RSM yang ditentukan.

Sintaks

DWORD SetNtmsObjectSecurity(
  [in] HANDLE               hSession,
  [in] LPNTMS_GUID          lpObjectId,
  [in] DWORD                dwType,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR lpSecurityDescriptor
);

Parameter

[in] hSession

Tangani ke sesi yang dikembalikan oleh fungsi OpenNtmsSession .

[in] lpObjectId

Pengidentifikasi unik objek RSM.

[in] dwType

Jenis objek RSM. Untuk daftar jenis objek, lihat NtmsObjectsTypes.

[in] SecurityInformation

Nilai SECURITY_INFORMATION yang menentukan informasi keamanan untuk ditulis ke objek RSM.

[in] lpSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang menentukan deskriptor keamanan untuk menulis ke objek RSM: NTMS_USE_ACCESS, NTMS_CONTROL_ACCESS, atau NTMS_MODIFY_ACCESS.

Menampilkan nilai

Fungsi ini mengembalikan salah satu nilai berikut.

Nilai Makna
ERROR_ACCESS_DENIED
 Hak istimewa yang diperlukan untuk memodifikasi deskriptor keamanan ditolak.
ERROR_DATABASE_FAILURE
 Database tidak dapat diakses atau rusak.
ERROR_DATABASE_FULL
 Database penuh.
ERROR_INVALID_HANDLE
 Handel sesi hilang atau tidak valid.
ERROR_INVALID_PARAMETER
 ID objek hilang.
ERROR_NO_SECURITY_ON_OBJECT
 Tidak ada informasi keamanan untuk obyek ini.
ERROR_OBJECT_NOT_FOUND
 ID objek tidak valid.
ERROR_SUCCESS
 Fungsi berhasil.

Keterangan

Jika aplikasi menggunakan SetNtmsObjectSecurity untuk mengatur daftar kontrol akses diskresi (ACL) objek, aplikasi harus memiliki izin WRITE_DAC atau menjadi pemilik objek.

Jika aplikasi menggunakan SetNtmsObjectSecurity untuk mengatur ACL sistem objek, hak istimewa SE_SECURITY_NAME harus diaktifkan untuk aplikasi. Untuk informasi selengkapnya, lihat fungsi SetPrivateObjectSecurity . Untuk informasi selengkapnya tentang keamanan RSM, lihat Keamanan RSM.

Persyaratan

   
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntmsapi.h
Pustaka Ntmsapi.lib
DLL Ntmsapi.dll

Lihat juga

EnumerateNtmsObject

GetNtmsObjectSecurity

Fungsi Manajemen Objek