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

Weitere Informationen

AddAccessAllowedAce

AddAccessDeniedAce

AddAce

AddAuditAccessAce

GetAclInformation

InitializeAcl

Low-Level-Access Control

Access Control funktionen auf niedriger Ebene