ZwMakeTemporaryObject 関数 (wdm.h)

ZwMakeTemporaryObject ルーチンは、オブジェクトの属性を一時的なものに変更します。

構文

NTSYSAPI NTSTATUS ZwMakeTemporaryObject(
  [in] HANDLE Handle
);

パラメーター

[in] Handle

任意の型の オブジェクトを処理します。

戻り値

ZwMakeTemporaryObject は、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラー コードを返します。

注釈

ZwMakeTemporaryObject は、任意の種類のオブジェクトを操作するジェネリック ルーチンです。

オブジェクトは、OBJ_PERMANENT オブジェクト属性を指定して作成された場合、永続的です。 (オブジェクト属性の詳細については、「 InitializeObjectAttributes」を参照してください)。永続的オブジェクトは参照カウント 1 で作成されるため、ドライバーが逆参照しても削除されません。

オブジェクトが永続的でない場合、オブジェクトは一時的なものです。 ZwMakeTemporaryObject は 、指定したオブジェクトを一時オブジェクトに変換します。 オブジェクトが既に一時的な場合、このルーチンは何も行いません。

一時オブジェクトの名前は、ハンドル数が 0 より大きい限りのみです。 ハンドル数が 0 に達すると、システムはオブジェクト名を削除し、オブジェクトのポインター数を適切に調整します。

この関数の呼び出しがユーザー モードで発生する場合は、"ZwMakeTemporaryObject" ではなく"NtMakeTemporaryObject" という名前を使用する必要があります。

カーネル モード ドライバーからの呼び出しの場合、Windows ネイティブ システム サービス ルーチンの NtXxx および ZwXxx バージョンは、入力パラメーターを処理および解釈する方法で動作が異なる場合があります。 ルーチンの NtXxx バージョンと ZwXxx バージョンの間の関係の詳細については、「ネイティブ システム サービス ルーチンの Nt バージョンと Zw バージョンの使用」を参照してください。

要件

要件	値
対象プラットフォーム	ユニバーサル
Header	wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library	NtosKrnl.lib
[DLL]	NtosKrnl.exe
IRQL	PASSIVE_LEVEL
DDI コンプライアンス規則	HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm)

こちらもご覧ください

InitializeObjectAttributes

Nt および Zw バージョンのネイティブ システム サービス ルーチンの使用

ZwClose

ZwCreateDirectoryObject

ZwCreateFile