IoWMISetSingleInstance 関数 (wdm.h)

  • [アーティクル]

IoWMISetSingleInstance ルーチンは、指定された WMI クラスとインスタンス名に一致するデータ ブロック インスタンス内のプロパティの値を設定します。

構文

NTSTATUS IoWMISetSingleInstance(
  [in] PVOID           DataBlockObject,
  [in] PUNICODE_STRING InstanceName,
  [in] ULONG           Version,
  [in] ULONG           ValueBufferSize,
  [in] PVOID           ValueBuffer
);

パラメーター

[in] DataBlockObject

WMI データ ブロック オブジェクトへのポインター。 呼び出し元は、 IoWMIOpenBlock ルーチンを使用して WMI クラスのデータ ブロック オブジェクトを開きます。 オブジェクトは、WMIGUID_SETアクセス権で開く必要があります。

[in] InstanceName

データ ブロックのインスタンスの名前を指定します。 この値は、 ブロックの InstanceName プロパティの値に対応します。

[in] Version

将来利用するために予約されています。 呼び出し元は、このパラメーターを 0 に設定する必要があります。

[in] ValueBufferSize

ValueBuffer パラメーターで渡されるバッファーのサイズをバイト単位で指定します。

[in] ValueBuffer

データ ブロック内のプロパティの新しい値を含むバッファーへのポインター。

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 操作が成功しました。 WMI データ ブロック インスタンス プロパティの値は、 ValueBuffer パラメーターによって指されるバッファーの内容に更新されます。
STATUS_WMI_GUID_NOT_FOUND
 WMI クラスを実装するドライバーはありません。
STATUS_WMI_INSTANCE_NOT_FOUND
 ドライバーは、InstanceName パラメーターで指定された値と等しい InstanceName プロパティを持つ WMI クラスの インスタンス を実装しません。
STATUS_WMI_READ_ONLY
 WMI クラスのすべてのプロパティは読み取り専用です。
STATUS_WMI_SET_FAILURE
 WMI データ ブロック インスタンスを実装するドライバーは、インスタンスを更新できません。

注釈

IoWMISetSingleInstance は、指定した WMI クラスとインスタンス名をサポートする可能性があるドライバーを決定し、そのようなドライバーごとに IRP_MN_CHANGE_SINGLE_INSTANCE 要求を発行します。 InstanceName プロパティが一致するデータ ブロック インスタンスをエクスポートするドライバーは、そのデータ ブロック インスタンスを更新します。 データ ブロックには、読み取り専用プロパティと読み取り/書き込みプロパティの両方がある場合があることに注意してください。 この場合、読み取り/書き込みプロパティのみが更新され、STATUS_SUCCESSが返されます。

ドライバーは、 IoWMISetSingleItem ルーチンを 使用して、クラス インスタンス内の 1 つのプロパティを更新することもできます。

要件

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

こちらもご覧ください

IRP_MN_CHANGE_SINGLE_INSTANCE

IoWMIOpenBlock

IoWMIQuerySingleInstance

IoWMISetSingleItem