IWbemConfigureRefresher::AddObjectByTemplate メソッド (wbemcli.h)
IWbemConfigureRefresher::AddObjectByTemplate メソッドを使用すると、IWbemClassObject インスタンス テンプレートを指定することで、更新するオブジェクトをリフレッシャーに追加できます。 このメソッドは、リフレッシャーに追加するオブジェクトのオブジェクト パスを構築するのが困難な場合に使用します。
構文
HRESULT AddObjectByTemplate(
IWbemServices *pNamespace,
[in] IWbemClassObject *pTemplate,
[in] long lFlags,
[in] IWbemContext *pContext,
[out] IWbemClassObject **ppRefreshable,
[out] long *plId
);
パラメーター
pNamespace
IWbemServices ポインターを Windows Management に戻します。これにより、プロバイダーによって行われた要求を処理できます。 実行中に Windows Management にコールバックする場合、プロバイダーはこのポインターで AddRef を呼び出す必要があります。
[in] pTemplate
インスタンス テンプレートを含む IWbemClassObject オブジェクトへのポインター。
[in] lFlags
このメソッドの動作を変更するフラグのビットマスク。 このパラメーターが WBEM_FLAG_USE_AMENDED_QUALIFIERS に設定されている場合、返されるインスタンスにはローカライズされた修飾子 (使用可能な場合) が含まれます。
[in] pContext
通常 は NULL です。それ以外の場合は、1 つ以上の動的クラス プロバイダーに必要な IWbemContext オブジェクトへのポインター。 コンテキスト オブジェクトの値は、特定のプロバイダードキュメントで指定する必要があります。 このパラメーターの詳細については、「 WMI への呼び出しの作成」を参照してください。
[out] ppRefreshable
更新可能なインスタンス オブジェクトを含む IWbemClassObject オブジェクトへの参照を保持するポインター。 クライアントは、不要になったときに、返されたオブジェクトに対して Release を 呼び出す必要があります。
[out] plId
この更新可能なオブジェクトを一意に識別するプロバイダーによって返される整数へのポインター。
戻り値
このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT に含まれる値の一覧です。
注釈
指定されたインスタンスは、High-Performance プロバイダーによって提供される有効なオブジェクトを指定する必要があります。 更新操作の処理中に、返されたオブジェクトをクライアントで変更することはできません。 返された識別子は、 Remove 関数でオブジェクトを削除するために使用できます。
ユーザーが追加されたオブジェクトを明示的に削除する必要はありません。 クライアントは、不要になったときに、返されたオブジェクトに対して Release を 呼び出す必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemcli.h (Wbemidl.h を含む) |
| Library | Wbemuuid.lib |