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 |