Fungsi GetAclInformation (securitybaseapi.h)

Artikel
03/15/2023

Fungsi GetAclInformation mengambil informasi tentang daftar kontrol akses (ACL).

Sintaks

BOOL GetAclInformation(
  [in]  PACL                  pAcl,
  [out] LPVOID                pAclInformation,
  [in]  DWORD                 nAclInformationLength,
  [in]  ACL_INFORMATION_CLASS dwAclInformationClass
);

Parameter

[in] pAcl

Penunjuk ke ACL. Fungsi ini mengambil informasi tentang ACL ini. Jika nilai null diteruskan, fungsi menyebabkan pelanggaran akses.

[out] pAclInformation

Penunjuk ke buffer untuk menerima informasi yang diminta. Struktur yang ditempatkan ke dalam buffer tergantung pada kelas informasi yang diminta dalam parameter dwAclInformationClass .

[in] nAclInformationLength

Ukuran, dalam byte, dari buffer yang diacu oleh parameter pAclInformation .

[in] dwAclInformationClass

Nilai enumerasi ACL_INFORMATION_CLASS yang menunjukkan kelas informasi yang diminta. Parameter ini bisa menjadi salah satu dari dua nilai dari enumerasi ini:

Jika nilainya adalah AclRevisionInformation, fungsi mengisi buffer yang diacu oleh parameter pAclInformation dengan struktur ACL_REVISION_INFORMATION .
Jika nilainya adalah AclSizeInformation, fungsi mengisi buffer yang diacu oleh parameter pAclInformation dengan struktur ACL_SIZE_INFORMATION .

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