IoWMIHandleToInstanceName 関数 (wdm.h)

  • [アーティクル]

IoWMIHandleToInstanceName ルーチンは、ファイル ハンドルで指定されたドライバーによって実装される WMI クラス インスタンスのインスタンス名を決定します。

構文

NTSTATUS IoWMIHandleToInstanceName(
  [in]  PVOID           DataBlockObject,
  [in]  HANDLE          FileHandle,
  [out] PUNICODE_STRING InstanceName
);

パラメーター

[in] DataBlockObject

WMI データ ブロック オブジェクトへのポインター。 呼び出し元は、 IoWMIOpenBlock ルーチンを使用して WMI クラスのデータ ブロック オブジェクトを開きます。

[in] FileHandle

ファイル ハンドルを指定します。 ルーチンは、ファイル ハンドルによって表されるドライバーに対応するインスタンス名を返します。

[out] InstanceName

ルーチンがインスタンス名を返すために使用する UNICODE_STRING 構造体へのポインター。 呼び出し元は、返されたバッファーを UNICODE_STRING内で解放します。

戻り値

ルーチンは NTSTATUS コードを返します。 可能な戻り値は次のとおりです。

リターン コード 説明
STATUS_SUCCESS
 操作が成功しました。 ルーチンは、InstanceName パラメーターが指すUNICODE_STRING構造体にインスタンス名を入力します。
STATUS_WMI_INSTANCE_NOT_FOUND
 ドライバーは、 DataBlockObject で指定された WMI クラスのインスタンスを実装しません。

要件

要件 値
サポートされている最小のクライアント Windows XP 以降のバージョンの Windows オペレーティング システムで使用できます。
対象プラットフォーム ユニバーサル
Header wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
Library NtosKrnl.lib
[DLL] NtosKrnl.exe
IRQL <= APC_LEVEL

こちらもご覧ください

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock