zwMakeTemporaryObject 函式 (wdm.h)

ZwMakeTemporaryObject 例程會變更對象的屬性，使其暫時性。

語法

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

[in] Handle

任何型別之物件的句柄。

ZwMakeTemporaryObject 會在成功時傳回STATUS_SUCCESS，或在失敗時傳回適當的 NTSTATUS 錯誤碼。

ZwMakeTemporaryObject 是在任何類型的對象上運作的泛型例程。

如果物件是以指定的OBJ_PERMANENT物件屬性建立，則為永久物件。 (如需物件屬性的詳細資訊，請參閱 InitializeObjectAttributes.) 使用參考計數 1 建立永久物件，因此在驅動程式取值時不會刪除。

如果物件不是永久的，則為暫時性。 ZwMakeTemporaryObject 會將指定的物件轉換成暫存物件。如果對象已經是暫時的，這個例程就不會執行任何動作。

只要暫存物件的句柄計數大於零，就具有名稱。當句柄計數達到零時，系統會刪除物件名稱，並適當地調整物件的指標計數。

如果在使用者模式中呼叫此函式，您應該使用名稱「NtMakeTemporaryObject」，而不是「ZwMakeTemporaryObject」。。

針對來自內核模式驅動程式的呼叫，Windows 原生系統服務例程的 NtXxx 和 ZwXxx 版本會以處理和解譯輸入參數的方式，以不同的方式運作。如需 例程 NtXxx 和 ZwXxx 版本之間關聯性的詳細資訊，請參閱使用原生系統服務例程的 Nt 和 Zw 版本。

需求	值
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI 合規性規則	HwStorPortProhibitedDIS (storport) 、 PowerIrpDDis (wdm)