Fungsi GetSecurityDescriptorSacl (securitybaseapi.h)

Artikel
03/15/2023

Fungsi GetSecurityDescriptorSacl mengambil penunjuk ke daftar kontrol akses sistem (SACL) dalam deskriptor keamanan tertentu.

Sintaks

BOOL GetSecurityDescriptorSacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbSaclPresent,
  [out] PACL                 *pSacl,
  [out] LPBOOL               lpbSaclDefaulted
);

Parameter

[in] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang berisi SACL tempat fungsi mengambil penunjuk.

[out] lpbSaclPresent

Penunjuk ke bendera yang diatur fungsi untuk menunjukkan keberadaan SACL dalam deskriptor keamanan yang ditentukan. Jika parameter ini TRUE, deskriptor keamanan berisi SACL, dan parameter output yang tersisa dalam fungsi ini menerima nilai yang valid. Jika parameter ini FALSE, deskriptor keamanan tidak berisi SACL, dan parameter output yang tersisa tidak menerima nilai yang valid.

[out] pSacl

Penunjuk ke penunjuk ke daftar kontrol akses (ACL). Jika SACL ada, fungsi mengatur penunjuk yang ditunjukkan oleh pSacl ke alamat SACL deskriptor keamanan. Jika SACL tidak ada, tidak ada nilai yang disimpan.

Jika fungsi menyimpan nilai NULL di penunjuk yang ditunjukkan oleh pSacl, deskriptor keamanan memiliki NULL SACL.

[out] lpbSaclDefaulted

Penunjuk ke bendera yang diatur ke nilai bendera SE_SACL_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL jika SACL ada untuk deskriptor keamanan.

Nilai kembali

Jika fungsi berhasil, fungsi mengembalikan bukan nol.

Jika fungsi gagal, fungsi akan mengembalikan nol. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2003 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	securitybaseapi.h (termasuk Windows.h)
Pustaka	Advapi32.lib
DLL	Advapi32.dll