GetExplicitEntriesFromAclA-Funktion (aclapi.h)

Artikel
02/28/2024

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