Provider::P utInstance(constCInstance&,long) メソッド (provider.h)

[Provider クラスは WMI プロバイダー フレームワークの一部であり、現在最終的な状態と見なされています。これらのライブラリに影響を与える、セキュリティ関連以外の問題に対しては、それ以上の開発、機能強化、または更新プログラムは利用できません。 すべての新規開発には、MI API を使用する必要があります。]

PutInstance メソッドは、インスタンスを更新します。

構文

HRESULT PutInstance(
  [ref] const CInstance & newInstance,
        long              lFlags
);

パラメーター

[ref] newInstance

更新されたインスタンス。

lFlags

更新操作に関する情報を含むフラグのビットマスク。 これは、 IWbemServices::P utInstance メソッドでクライアントによって指定された値です。

次のフラグは、WMI によって処理 (および除外) されます。

• WBEM_FLAG_RETURN_IMMEDIATELY

• WBEM_FLAG_CREATE_ONLY
• WBEM_FLAG_CREATE_OR_UPDATE
• WBEM_FLAG_UPDATE_ONLY

戻り値

このメソッドの既定のフレームワーク プロバイダー実装では、 呼 び出し元のメソッドにWBEM_E_PROVIDER_NOT_CAPABLEが返されます。 IWbemServices::P utInstance メソッドには、最も一般的な戻り値が一覧表示されますが、任意の COM リターン コードを返すことができます。

注釈

クライアントがクラスに対して IWbemServices::P utInstance を呼び出すと、WMI は PutInstance を呼び出します。 フレームワーク プロバイダーがインスタンスを更新する場合 は、PutInstance を実装する必要があります。 次の一覧では、 PutInstance の一般的な実装について説明します。

1. CInstance の Get メソッド (CInstance::GetCHString など) を使用して、クライアントによって渡されるキー プロパティを調べます。

   実装では、プロバイダーがクライアントによって要求された変更をサポートしているかどうかを判断する必要があります。

2. 必要に応じて、適切なマネージド オブジェクトを作成または更新します。
3. 適切な戻り値を返します。

   プロバイダーがクライアントから要求された変更をサポートしていない場合は、適切なエラー コードを返す必要があります。 有効なエラー コードの完全な一覧については、「 IWbemServices::P utInstance」を参照してください。

要件