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