ZwClose 関数 (wdm.h)

[アーティクル]
02/27/2024

ZwClose ルーチンは、オブジェクトハンドルを閉じます。

構文

NTSYSAPI NTSTATUS ZwClose(
  [in] HANDLE Handle
);

パラメーター

[in] Handle

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

戻り値

ZwClose は 、成功した場合はSTATUS_SUCCESS、失敗した場合は適切な NTSTATUS エラーコードを返します。特に、 Handle が有効なハンドルでない場合はSTATUS_INVALID_HANDLEを返し、呼び出し元のスレッドにハンドルを閉じる権限がない場合はSTATUS_HANDLE_NOT_CLOSABLEを返します。

注釈

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

開いているオブジェクトハンドルを閉じると、そのハンドルが無効になります。また、オブジェクトのハンドル数をデクリメントし、オブジェクトを削除できるかどうかを確認します。システムは、オブジェクトのすべてのハンドルが閉じられ、参照されたポインターが残らないまで、オブジェクトを実際に削除しません。

ドライバーは、ハンドルが不要になったらすぐに開くすべてのハンドルを閉じる必要があります。カーネルハンドルは、システムスレッドまたはOBJ_KERNEL_HANDLE フラグを指定して開かれるハンドルであり、前のプロセッサモードが KernelMode の場合にのみ閉じることができます。この要件は、システムスレッドと、カーネルモードから発行された IRP のディスパッチルーチンの両方に適用されます。 (以前のプロセッサモードの詳細については、「 ExGetPreviousMode」を参照してください)。たとえば、 ZwCreateKey が DriverEntry ルーチンに返すハンドルを、同じドライバーのディスパッチルーチンで閉じることはできません。 DriverEntry ルーチンはシステムプロセスで実行されますが、ディスパッチルーチンは通常、現在の I/O 要求を発行するスレッドのコンテキストで、または下位レベルのドライバーの場合は任意のスレッドコンテキストで実行されます。

カーネル以外のハンドルは、前のプロセッサモードが KernelMode であるか、呼び出し元のスレッドがハンドルを閉じるのに十分なアクセス許可を持っているという 2 つの条件のいずれかが満たされている場合にのみ閉じることができます。後者の例は、呼び出し元のスレッドがハンドルを作成したスレッドである場合に発生します。

ZwClose の呼び出し元は、このルーチンが返される前にすべての I/O が完了するまで自動的に待機することを想定しないでください。

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

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

要件

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