GetExplicitEntriesFromAclA function (aclapi.h)
Die GetExplicitEntriesFromAcl-Funktion ruft ein Array von Strukturen ab, die die Zugriffssteuerungseinträge (ACEs) in einer Zugriffssteuerungsliste (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, aus 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, wird ein nichtzero-Fehlercode zurückgegeben, der in WinError.h definiert ist.
Bemerkungen
Jeder Eintrag im Array EXPLICIT_ACCESS Strukturen beschreibt Zugriffssteuerungsinformationen aus einer ACE- für einen Trustee. Ein Trustee 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 Zugriffsmodus-Flag an, das angibt, ob die ACE die angegebenen Rechte zulässt, verweigert oder überwacht.
Für eine diskretionäre Zugriffssteuerungsliste (DACL) kann das Zugriffsmodus-Flag entweder GRANT_ACCESS oder DENY_ACCESS sein. Informationen zu diesen Werten finden Sie unter ACCESS_MODE.
Bei einer Systemzugriffssteuerungsliste (SACL) kann das Zugriffsmodus-Flag SET_AUDIT_ACCESS, SET_AUDIT_FAILURE oder beides sein. Informationen zu diesen Werten finden Sie unter ACCESS_MODE.
Anmerkung
Der Header "aclapi.h" definiert GetExplicitEntriesFromAcl als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, 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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [Desktop-Apps | UWP-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Desktop-Apps | UWP-Apps] |
| Zielplattform- | Fenster |
| Header- | aclapi.h |
| Library | Advapi32.lib |
| DLL- | Advapi32.dll |