共用方式為


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 原生系統服務例程的 NtXxxZwXxx 版本會以處理和解譯輸入參數的方式,以不同的方式運作。 如需 例程 NtXxxZwXxx 版本之間關聯性的詳細資訊,請參閱 使用原生系統服務例程的 Nt 和 Zw 版本

規格需求

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

另請參閱

InitializeObjectAttributes

使用 Nt 和 Zw 版本的原生系統服務例程

ZwClose

ZwCreateDirectoryObject

ZwCreateFile