IWbemConfigureRefresher::AddEnum メソッド (wbemcli.h)

IWbemConfigureRefresher::AddEnum メソッドは、要求されたリフレッシャーに列挙子を追加します。

構文

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

パラメーター

[in] pNamespace

IWbemServices ポインターを Windows Management に戻します。これにより、プロバイダーによって行われた要求を処理できます。 メソッドが実行中に Windows Management にコールバックする必要がある場合、プロバイダーは pNamespace ポインターを使用して AddRef を呼び出す必要があります。

[in] wszClassName

列挙されるクラスの名前を含む 16 ビット Unicode 文字の null で終わる定数文字列。

[in] lFlags

このメソッドの動作を変更するフラグのビットマスク。 このパラメーターが WBEM_FLAG_USE_AMENDED_QUALIFIERS に設定されている場合、返されるインスタンスにはローカライズされた修飾子 (使用可能な場合) が含まれます。

[in] pContext

通常 は NULL です。それ以外の場合、これは、1 つ以上の動的クラス プロバイダーに必要な IWbemContext オブジェクトへのポインターです。 コンテキスト オブジェクトの値は、特定のプロバイダードキュメントで指定する必要があります。 このパラメーターの詳細については、「 WMI への呼び出しの作成」を参照してください。

[out] ppEnum

列挙体を含む IWbemHiPerfEnum オブジェクトへの参照を保持するポインター。 クライアントは、不要になったときに、このポインターで Release を呼び出す必要があります。

[out] plId

更新可能な列挙を一意に識別するプロバイダーによって返される整数へのポインター。

戻り値

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 内に含まれる値の一覧です。

Remarks

指定されたクラスは、High-Performance プロバイダーによって提供される有効なクラスを指定する必要があります。 返された列挙子のすべてのインスタンスは、呼び出し後に照会できます。 更新の呼び出しごとに、列挙子内のインスタンスの数が異なる場合があります。 指定したクラス名のインスタンスのみが返されます。詳細な列挙はサポートされていないため、指定したクラスのサブクラスは列挙されません。 更新操作の処理中に、返された列挙子をクライアントが操作しないようにする必要があります。 返された識別子は、 Remove 関数でオブジェクトを削除するために使用できます。 追加された列挙子をユーザーが明示的に削除する必要はありません。 ただし、クライアントは、不要になったときに、返された列挙子で Release を呼び出す必要があります。

要件

こちらもご覧ください

IWbemConfigureRefresher