GetAclInformation-Funktion (securitybaseapi.h)

Artikel
08/25/2023

Die GetAclInformation-Funktion ruft Informationen zu einer Zugriffssteuerungsliste (Access Control List , ACL) ab.

Syntax

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

Parameter

[in] pAcl

Ein Zeiger auf eine ACL. Die Funktion ruft Informationen zu dieser ACL ab. Wenn ein NULL-Wert übergeben wird, verursacht die Funktion eine Zugriffsverletzung.

[out] pAclInformation

Ein Zeiger auf einen Puffer zum Empfangen der angeforderten Informationen. Die Struktur, die im Puffer platziert wird, hängt von der im dwAclInformationClass-Parameter angeforderten Informationsklasse ab.

[in] nAclInformationLength

Die Größe des Puffers in Bytes, auf den der pAclInformation-Parameter verweist.

[in] dwAclInformationClass

Ein Wert der ACL_INFORMATION_CLASS-Enumeration , der die Klasse der angeforderten Informationen angibt. Dieser Parameter kann einer von zwei Werten aus dieser Enumeration sein:

Wenn der Wert AclRevisionInformation ist, füllt die Funktion den Puffer, auf den der pAclInformation-Parameter verweist, mit einer ACL_REVISION_INFORMATION-Struktur .
Wenn der Wert AclSizeInformation ist, füllt die Funktion den Puffer, auf den der pAclInformation-Parameter verweist, mit einer ACL_SIZE_INFORMATION-Struktur .

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion nonzero zurück.

Wenn die Funktion fehlschlägt, gibt sie null zurück. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll