Fungsi GetSecurityDescriptorDacl (securitybaseapi.h)

Artikel
03/13/2024

Fungsi GetSecurityDescriptorDacl mengambil penunjuk ke daftar kontrol akses diskresi (DACL) dalam deskriptor keamanan tertentu.

Sintaks

BOOL GetSecurityDescriptorDacl(
  [in]  PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [out] LPBOOL               lpbDaclPresent,
  [out] PACL                 *pDacl,
  [out] LPBOOL               lpbDaclDefaulted
);

Parameter

[in] pSecurityDescriptor

Penunjuk ke struktur SECURITY_DESCRIPTOR yang berisi DACL. Fungsi ini mengambil penunjuk ke dalamnya.

[out] lpbDaclPresent

Penunjuk ke nilai yang menunjukkan keberadaan DACL dalam deskriptor keamanan yang ditentukan. Jika lpbDaclPresentTRUE, deskriptor keamanan berisi DACL, dan parameter output yang tersisa dalam fungsi ini menerima nilai yang valid. Jika lpbDaclPresentadalah FALSE, deskriptor keamanan tidak berisi DACL, dan parameter output yang tersisa tidak menerima nilai yang valid.

Nilai TRUE untuk lpbDaclPresent tidak berarti bahwa pDacl bukan NULL. Artinya, lpbDaclPresent dapat true sementara pDacl adalah NULL, yang berarti bahwa NULL DACL berlaku. DACL NULL secara implisit memungkinkan semua akses ke objek dan tidak sama dengan DACL kosong. DACL kosong tidak mengizinkan akses ke objek. Untuk informasi tentang membuat DACL yang tepat, lihat Membuat DACL.

[out] pDacl

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

Jika fungsi menyimpan nilai NULL dalam penunjuk yang ditunjukkan oleh pDacl, deskriptor keamanan memiliki NULL DACL. DACL NULL secara implisit memungkinkan semua akses ke objek.

Jika aplikasi mengharapkan DACL non-NULL tetapi mengalami DACL NULL , aplikasi harus gagal dengan aman dan tidak mengizinkan akses.

[out] lpbDaclDefaulted

Penunjuk ke bendera yang diatur ke nilai bendera SE_DACL_DEFAULTED dalam struktur SECURITY_DESCRIPTOR_CONTROL jika DACL ada untuk deskriptor keamanan. Jika bendera ini TRUE, DACL diambil oleh mekanisme default; jika FALSE, DACL secara eksplisit ditentukan oleh pengguna.

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