Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ZwDeleteFile Routine löscht die angegebene Datei.
Syntax
NTSYSAPI NTSTATUS ZwDeleteFile(
[in] POBJECT_ATTRIBUTES ObjectAttributes
);
Parameter
[in] ObjectAttributes
Ein Zeiger auf eine OBJECT_ATTRIBUTES Struktur, die die vom Aufrufer bereitgestellten Attribute enthält, die für das Dateiobjekt verwendet werden sollen. Zu diesen Attributen gehören beispielsweise die ObjectName- und die SECURITY_DESCRIPTOR. Dieser Parameter wird durch Aufrufen des InitializeObjectAttributes Makros initialisiert.
Rückgabewert
ZwDeleteFile- gibt STATUS_SUCCESS oder einen entsprechenden Fehlerstatus zurück, der den endgültigen Abschlussstatus des Vorgangs darstellt. Mögliche Fehlerstatuscodes sind:
| Rückgabecode | Beschreibung |
|---|---|
| STATUS_INSUFFICIENT_RESOURCES | Ein temporärer Puffer, der von dieser Funktion benötigt wird, konnte nicht zugeordnet werden. |
| STATUS_INVALID_PARAMETER | Der angegebene ObjectAttributes- Parameter war ein NULL-Zeiger, kein gültiger Zeiger auf eine OBJECT_ATTRIBUTES-Struktur, oder einige der angegebenen ObjectAttributes Strukturmember waren ungültig. |
| STATUS_OBJECT_NAME_INVALID | Der ObjectAttributes- Parameter enthielt eine ObjectName- in der OBJECT_ATTRIBUTES Struktur, die ungültig war, da nach dem OBJECT_NAME_PATH_SEPARATOR Zeichen eine leere Zeichenfolge gefunden wurde. |
| STATUS_OBJECT_NAME_NOT_FOUND | Der ObjectAttributes- Parameter enthielt ein ObjectName-Element Element in der OBJECT_ATTRIBUTES Struktur, die nicht gefunden werden konnte. |
| STATUS_OBJECT_PATH_NOT_FOUND | Der ObjectAttributes- Parameter enthielt ein ObjectName Element in der OBJECT_ATTRIBUTES-Struktur mit einem Objektpfad, der nicht gefunden werden konnte. |
| STATUS_OBJECT_PATH_SYNTAX_BAD | Der ObjectAttributes--Parameter enthielt kein RootDirectory-element, aber das ObjectName-Element in der OBJECT_ATTRIBUTES-Struktur war eine leere Zeichenfolge oder enthielt kein OBJECT_NAME_PATH_SEPARATOR Zeichen. Dies gibt eine falsche Syntax für den Objektpfad an. |
Bemerkungen
ZwDeleteFile das angegebene Dateiobjekt löscht.
Die ZwDeleteFile--Funktion wird aufgerufen, nachdem das InitializeAttributes Makros verwendet wird, um Attribute in der OBJECT_ATTRIBUTES Struktur festzulegen, damit das Dateiobjekt gelöscht werden soll.
Es gibt zwei alternative Möglichkeiten, den Namen der Datei anzugeben, die mit ZwDeleteFile-gelöscht werden soll:
- Als vollqualifizierter Pfadname, der im ObjectName Member der Eingabe ObjectAttributes-
- Als Pfadname relativ zur Verzeichnisdatei, die durch das Handle im RootDirectory Member der Eingabe ObjectAttributes dargestellt wird
Aufrufer von ZwDeleteFile- müssen unter IRQL = PASSIVE_LEVEL und mit speziellen Kernel-APCs ausgeführt werden, dieaktiviert sind.
Wenn der Aufruf der ZwDeleteFile--Funktion im Benutzermodus auftritt, sollten Sie den Namen "NtDeleteFile " anstelle von "ZwDeleteFile" verwenden.
Bei Aufrufen von Kernelmodustreibern können sich die NtXxx und ZwXxx- Versionen einer Windows Native System Services-Routine anders verhalten, wie sie Eingabeparameter behandeln und interpretieren. Weitere Informationen zur Beziehung zwischen den NtXxx und ZwXxx- Versionen einer Routine finden Sie unter Using Nt and Zw Versions of the Native System Services Routines.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows XP |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | PASSIVE_LEVEL (siehe Abschnitt "Hinweise") |
| DDI-Complianceregeln | HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm) |