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) |