ZwMakeTemporaryObject-Funktion (wdm.h)

Die ZwMakeTemporaryObject-Routine ändert die Attribute eines Objekts, um es temporär zu machen.

Syntax

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

Parameter

[in] Handle

Behandeln Sie ein Objekt eines beliebigen Typs.

Rückgabewert

ZwMakeTemporaryObject gibt bei Erfolg STATUS_SUCCESS oder den entsprechenden NTSTATUS-Fehlercode bei Fehler zurück.

Hinweise

ZwMakeTemporaryObject ist eine generische Routine, die für jeden Objekttyp ausgeführt wird.

Ein Objekt ist dauerhaft, wenn es mit dem angegebenen OBJ_PERMANENT-Objekt-Attribut erstellt wurde. (Weitere Informationen zu Objektattributen finden Sie unter InitializeObjectAttributes.) Ein permanentes Objekt wird mit einer Verweisanzahl von 1 erstellt, sodass es nicht gelöscht wird, wenn es von einem Treiber abgeleitet wird.

Ein Objekt ist temporär, wenn es nicht dauerhaft ist. ZwMakeTemporaryObject wandelt das angegebene Objekt in ein temporäres Objekt um. Wenn das Objekt bereits temporär ist, führt diese Routine nichts aus.

Ein temporäres Objekt hat nur einen Namen, solange seine Handleanzahl größer als 0 ist. Wenn die Handleanzahl 0 erreicht, löscht das System den Objektnamen und passt die Zeigeranzahl des Objekts entsprechend an.

Wenn der Aufruf dieser Funktion im Benutzermodus erfolgt, sollten Sie den Namen "NtMakeTemporaryObject" anstelle von "ZwMakeTemporaryObject" verwenden.

Bei Aufrufen von Kernelmodustreibern können sich die NtXxx - und ZwXxx-Versionen einer Windows Native System Services-Routine anders verhalten, da sie Eingabeparameter verarbeiten und interpretieren. Weitere Informationen zur Beziehung zwischen den Nt Xxx- und ZwXxx-Versionen einer Routine finden Sie unter Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
Header	wdm.h (einschließlich Wdm.h, Ntddk.h, Ntifs.h)
Bibliothek	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI-Complianceregeln	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

Weitere Informationen

InitializeObjectAttributes

Verwenden von Nt- und Zw-Versionen der Systemdienstroutinen

ZwClose

ZwCreateDirectoryObject

ZwCreateFile