次の方法で共有

IWbemHiPerfProvider::GetObjects メソッド (wbemprov.h)

  • [アーティクル]

IWbemHiPerfProvider::GetObjects メソッドは、指定された配列内のオブジェクトのキー以外のプロパティを挿入します。 WMI は、IWbemServices::GetObject 呼び出しに応答して GetObjects を呼び出します。 プロバイダーが GetObjects を実装していない場合、WMI は IWbemHiPerfProvider::CreateRefreshableObject メソッドを呼び出して GetObject 要求を処理しようとします。

メモ プロバイダーがこのメソッドを実装していない場合は、 WBEM_E_PROVIDER_NOT_CAPABLEを返す必要があります。
 

構文

HRESULT GetObjects(
  [in]      IWbemServices     *pNamespace,
  [in]      long              lNumObjects,
  [in, out] IWbemObjectAccess **apObj,
            long              lFlags,
            IWbemContext      *pContext
);

パラメーター

[in] pNamespace

IWbemServices ポインターを Windows Management に戻します。このポインターは、プロバイダーによって行われた要求にサービスを提供できます。 実行中に Windows Management にコールバックする場合、プロバイダーはこのポインターで AddRef を呼び出す必要があります。

[in] lNumObjects

取得するオブジェクトの数を含む整数。

[in, out] apObj

IWbemObjectAccess オブジェクトの配列へのポインター。 GetObjects メソッドは、各オブジェクトのキー プロパティをこの配列に挿入します。

lFlags

予約済み。 このパラメーターは、0 にする必要があります。

pContext

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

戻り値

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

解説

要求されたオブジェクトには、キー プロパティが入力されます。

例

次のコード例では、 GetObjects を実装する方法について説明します。

HRESULT CMyHiPerfProvider::GetObjects(
  /* [in] */IWbemServices *pNamespace,
  /* [in] */  long lNumObjects,
  /* [in,out] */IWbemObjectAccess **apObj,
  /* [in] */long lFlags,
  /* [in] */IWbemContext *pCtx
)
{

  for ( long i = 0; i < lNumObjects; i++ )
  {
      // Validate the instance (that is, ensure
      // the path is good); if it fails, return
      // the error.

      // For example, create a method that validates
      // the IWbemObjectAccess instance and returns
      // false if validation failed.
      /*if ( !ValidateInstance( apObj[i] ) )
          return WBEM_E_NOT_FOUND;*/

      // Fill out the instance.
      // For example, create a method that assigns
      // a value to the IWbemObjectAccess instance.
      /*FillInstance( apObj[i] );*/
  }

  return WBEM_S_NO_ERROR;
}

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー wbemprov.h (Wbemidl.h を含む)
Library Wbemuuid.lib
[DLL] Wmiprvsd.dll

関連項目

WMI プロバイダーの開発

IWbemHiPerfProvider

インスタンス プロバイダーをハイパフォーマンス プロバイダーに変換する

パフォーマンス カウンタ プロバイダ

インスタンス プロバイダーの作成