IWbemRefresher

列挙子オブジェクトやリフレッシャーオブジェクトなど、更新可能なオブジェクトを更新するためのエントリポイントを提供します。

IWbemRefresher::Refresh メソッドは、すべての更新可能なオブジェクト、列挙子、および入れ子になったリフレッシャーを更新します。WMI リフレッシャーは、クライアントからの更新要求に応じてこの関数を呼び出します。

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。以下に、HRESULT に格納される値を示します。

列挙子やオブジェクトを更新する際、プロバイダーはできる限り短時間で処理を完了すべきです。 IWbemObjectAccess のメソッドを使用し、プロパティハンドルをキャッシュして再利用することで、パフォーマンスを大幅に向上させることができます。列挙子を更新する際、プロバイダーはすべてのオブジェクトを削除して再生成することも、変更されたインスタンスのみを削除して追加することもできます。どちらの方法が最適かは実装者が判断します。いずれの場合も、インスタンスをキャッシュすることでパフォーマンスを向上させることができます。

プロバイダーは、 IWbemRefresher::Refresh の呼び出しに応じる場合にのみ、リフレッシャー内のオブジェクトおよび列挙子にアクセスすべきです。ただし、 Refresh が呼び出されたときに備えて、これらのオブジェクトに格納するデータをバックグラウンドスレッドでポーリングして準備しておくことは、まったく問題ありません。

例

次のコード例は、 Refresh の実装方法を示しています。

HRESULT CMyHiPerfProviderRefresher::Refresh(
/* [in] */long lFlags
)
{
  // Run through all the objects and update their
  // data.

  // Now run through the enumerators.
  // Empty the enumerator and refill it.
   

  return WBEM_S_NO_ERROR;
}