次の方法で共有

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 オペレーティング システムで使用できます。
ターゲット プラットフォーム の 万国
ヘッダー wdm.h (Wdm.h、Ntddk.h、Ntifs.h を含む)
ライブラリ NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

関連項目

DEVICE_OBJECT

IoWMIDeviceObjectToInstanceName

IoWMIOpenBlock の