FindFirstFreeAce-Funktion (securitybaseapi.h)

Die FindFirstFreeAce-Funktion ruft einen Zeiger auf das erste freie Byte in einer Zugriffssteuerungsliste (Access Control List , ACL) ab.

Syntax

BOOL FindFirstFreeAce(
  [in]  PACL   pAcl,
  [out] LPVOID *pAce
);

Parameter

[in] pAcl

Ein Zeiger auf eine ACL.

[out] pAce

Die Adresse eines Zeigers auf die erste freie Position in der ACL, die erstellt wird, wenn die Funktion zurückgibt. Wenn die ACL ungültig ist, ist dieser Parameter NULL. Wenn die ACL voll ist, zeigt dieser Parameter auf das Byte unmittelbar nach der ACL.

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 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	securitybaseapi.h (einschließlich Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll

Weitere Informationen

GetAce

GetAclInformation

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene