GetAce-Funktion (securitybaseapi.h)
Die GetAce-Funktion ruft einen Zeiger auf einen Zugriffssteuerungseintrag (Access Control Entry , ACE) in einer Zugriffssteuerungsliste (Access Control List , ACL) ab.
Syntax
BOOL GetAce(
[in] PACL pAcl,
[in] DWORD dwAceIndex,
[out] LPVOID *pAce
);
Parameter
[in] pAcl
Ein Zeiger auf eine ACL, die den abzurufenden ACE enthält.
[in] dwAceIndex
Der Index des abzurufenden ACE. Ein Wert von 0 entspricht dem ersten ACE in der ACL, einem Wert von eins bis zum zweiten ACE usw.
[out] pAce
Ein Zeiger auf einen Zeiger, den die Funktion auf die Adresse des ACE festlegt.
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
| 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 |