GetExplicitEntriesFromAclA-Funktion (aclapi.h)
Die GetExplicitEntriesFromAcl-Funktion ruft ein Array von Strukturen ab, die die Zugriffssteuerungseinträge (Access Control Entries , ACEs) in einer Zugriffssteuerungsliste (Access Control List , ACL) beschreiben.
Syntax
DWORD GetExplicitEntriesFromAclA(
[in] PACL pacl,
[out] PULONG pcCountOfExplicitEntries,
[out] PEXPLICIT_ACCESS_A *pListOfExplicitEntries
);
Parameter
[in] pacl
Ein Zeiger auf eine ACL-Struktur , von der ACE-Informationen abgerufen werden sollen.
[out] pcCountOfExplicitEntries
Ein Zeiger auf eine Variable, die die Anzahl der EXPLICIT_ACCESS Strukturen empfängt, die im pListOfExplicitEntries-Array zurückgegeben werden.
[out] pListOfExplicitEntries
Ein Zeiger auf eine Variable, die einen Zeiger auf ein Array von EXPLICIT_ACCESS Strukturen empfängt, die die ACEs in der ACL beschreiben. Wenn die Funktion erfolgreich ist, müssen Sie die LocalFree-Funktion aufrufen, um den zurückgegebenen Puffer freizugeben.
Rückgabewert
Wenn die Funktion erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.
Wenn die Funktion fehlschlägt, gibt sie einen nichtzero-Fehlercode zurück, der in WinError.h definiert ist.
Hinweise
Jeder Eintrag im Array von EXPLICIT_ACCESS-Strukturen beschreibt Zugriffssteuerungsinformationen von einem ACE für einen Treuhänder. Ein Treuhänder kann ein Benutzer, eine Gruppe oder ein Programm (z. B. ein Windows-Dienst) sein.
Jede EXPLICIT_ACCESS-Struktur gibt einen Satz von Zugriffsrechten und ein Zugriffsmodusflag an, das angibt, ob der ACE die angegebenen Rechte zulässt, verweigert oder überwacht.
Bei einer diskretionären Zugriffssteuerungsliste (DACL) kann das Zugriffsmodusflag entweder GRANT_ACCESS oder DENY_ACCESS sein. Informationen zu diesen Werten finden Sie unter ACCESS_MODE.
Für eine Systemzugriffssteuerungsliste (System Access Control List , SACL) kann das Zugriffsmodusflag SET_AUDIT_ACCESS, SET_AUDIT_FAILURE oder beides sein. Informationen zu diesen Werten finden Sie unter ACCESS_MODE.
Hinweis
Der aclapi.h-Header definiert GetExplicitEntriesFromAcl als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
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 | aclapi.h |
Bibliothek | Advapi32.lib |
DLL | Advapi32.dll |