GetExplicitEntriesFromAclA function (aclapi.h)

2024-11-20

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