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 die zu löschende ACE an. Ein Wert von Null entspricht der ersten ACE in der ACL, 1 der 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 umfassen:
- Die angegebene ACL ist ungültig.
- Der angegebene Indexwert liegt außerhalb des zulässigen Bereichs.
- STATUS_INVALID_PARAMETER ist ein Fehlercode.
Bemerkungen
Informationen zum Berechnen der Größe einer ACL finden Sie im Abschnitt "Hinweise" des Referenzeintrags für RtlCreateAcl.
Um einer ACL eine ACE hinzuzufügen, verwenden Sie RtlAddAce.
Um einen Zeiger auf eine ACE in einer ACL zu erhalten, verwenden Sie RtlGetAce.
Weitere Informationen zur Sicherheits- und Zugriffssteuerung finden Sie unter Windows-Sicherheitsmodell für Treiberentwickler und die Dokumentation zu diesen Themen im Windows SDK.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Server 2003 SP1 |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |