RtlDeleteAce-Funktion (ntifs.h)
Die RtlDeleteAce-Routine löscht einen Zugriffssteuerungseintrag (Access Control Entry, ACE) aus einer angegebenen Zugriffssteuerungsliste (Access Control List, ACL).
Syntax
NTSYSAPI NTSTATUS RtlDeleteAce(
[in, out] PACL Acl,
[in] ULONG AceIndex
);
Parameter
[in, out] Acl
Zeiger auf die zu ändernde ACL. RtlDeleteAce löscht die angegebene ACE aus dieser ACL.
[in] AceIndex
Gibt den zu löschenden ACE an. Der Wert 0 (null) entspricht dem ersten ACE in der ACL, 1 dem zweiten ACE usw.
Rückgabewert
RtlDeleteAce gibt STATUS_SUCCESS oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INVALID_PARAMETER | Einer der Parameterwerte war ungültig. |
Mögliche Gründe für STATUS_INVALID_PARAMETER sind:
- Die angegebene ACL ist ungültig.
- Der angegebene Indexwert liegt außerhalb des Bereichs.
- STATUS_INVALID_PARAMETER ist ein Fehlercode.
Hinweise
Informationen zum Berechnen der Größe einer Zugriffssteuerungsliste finden Sie im Abschnitt Hinweise des Referenzeintrags für RtlCreateAcl.
Verwenden Sie RtlAddAce, um einer ACL einen ACE hinzuzufügen.
Verwenden Sie RtlGetAce, um einen Zeiger auf einen ACE in einer ACL zu erhalten.
Weitere Informationen zur Sicherheit und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und in der Dokumentation zu diesen Themen im Windows SDK.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Server 2003 SP1 |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |