DeleteAce-Funktion (securitybaseapi.h)
Die DeleteAce-Funktion löscht einen Zugriffssteuerungseintrag (Access Control Entry , ACE) aus einer Zugriffssteuerungsliste (Access Control List , ACL).
Syntax
BOOL DeleteAce(
[in, out] PACL pAcl,
[in] DWORD dwAceIndex
);
Parameter
[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.
Rückgabewert
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.
Hinweise
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.
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 | securitybaseapi.h (Einschließen von Windows.h) |
| Bibliothek | Advapi32.lib |
| DLL | Advapi32.dll |