Share via

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
有効な lFlags 値 は次のとおりです。
  • 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」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー provider.h (FwCommon.h を含む)
Library FrameDyn.lib
[DLL] FrameDynOS.dll;FrameDyn.dll