DeleteAce-Funktion (securitybaseapi.h)

Syntax

BOOL DeleteAce(
  [in, out] PACL  pAcl,
  [in]      DWORD dwAceIndex
);

[in, out] pAcl

Ein Zeiger auf eine ACL. Der vom dwAceIndex-Parameter angegebene ACE wird aus dieser ACL entfernt.

[in] dwAceIndex

Der zu löschende ACE. Der Wert 0 (null) entspricht dem ersten ACE in der ACL, dem Wert 1 bis zum zweiten ACE usw.

Wenn die Funktion erfolgreich ist, gibt die Funktion ungleich null zurück.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Eine Anwendung kann die von der GetAclInformation-Funktion abgerufene ACL_SIZE_INFORMATION-Struktur verwenden, um die Größe der ACL und die Anzahl der darin enthaltenen ACEs zu ermitteln. Die GetAce-Funktion ruft Informationen zu einem einzelnen ACE ab.

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	securitybaseapi.h (Einschließen von Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll