ISecurityInformation::GetSecurity method (aclui.h)

Artikel
02/26/2024

Metode GetSecurity meminta deskriptor keamanan untuk objek yang dapat diamankan yang deskriptor keamanannya sedang diedit. Editor kontrol akses memanggil metode ini untuk mengambil deskriptor keamanan objek saat ini atau default.

Sintaks

HRESULT GetSecurity(
  [in]  SECURITY_INFORMATION RequestedInformation,
  [out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
  [in]  BOOL                 fDefault
);

Parameter

[in] RequestedInformation

Sekumpulan bendera bit SECURITY_INFORMATION yang menunjukkan bagian deskriptor keamanan yang diminta. Parameter ini bisa menjadi kombinasi dari nilai berikut.

Nilai	Makna
OWNER_SECURITY_INFORMATION	Deskriptor keamanan harus menyertakan SID pemilik objek.
GROUP_SECURITY_INFORMATION	Deskriptor keamanan harus menyertakan SID grup utama objek.
DACL_SECURITY_INFORMATION	Deskriptor keamanan harus menyertakan DACL objek.
SACL_SECURITY_INFORMATION	Deskriptor keamanan harus menyertakan SACL objek.

[out] ppSecurityDescriptor

Penunjuk ke variabel yang harus diatur implementasi Anda ke penunjuk ke deskriptor keamanan objek. Deskriptor keamanan harus menyertakan komponen yang diminta oleh parameter RequestedInformation .

Sistem memanggil fungsi LocalFree untuk membebaskan penunjuk yang dikembalikan.

[in] fDefault

Jika parameter ini TRUE, ppSecurityDescriptor harus mengembalikan deskriptor keamanan default yang ditentukan aplikasi untuk objek tersebut. Editor kontrol akses menggunakan pendeskripsi keamanan default ini untuk menginisialisasi ulang halaman properti.

Editor kontrol akses mengatur parameter ini ke TRUE hanya jika pengguna mengklik tombol Default . Tombol Default ditampilkan hanya jika Anda mengatur bendera SI_RESET di metode ISecurityInformation::GetObjectInformation . Jika tidak ada deskriptor keamanan default yang tersedia, jangan atur bendera SI_RESET.

Jika bendera ini FALSE, ppSecurityDescriptor harus mengembalikan deskriptor keamanan objek saat ini.

Menampilkan nilai

Mengembalikan S_OK jika berhasil.

Mengembalikan kode kesalahan bukan nol jika terjadi kesalahan. Mengembalikan E_ACCESSDENIED jika pengguna tidak memiliki izin untuk membaca informasi keamanan yang diminta.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	aclui.h