IWbemServices::GetObject メソッド (wbemcli.h)

  • [アーティクル]

IWbemServices::GetObject メソッドは、クラスまたはインスタンスを取得します。 このメソッドは、現在の IWbemServices オブジェクトに関連付けられている名前空間からオブジェクトのみを取得します。

構文

HRESULT GetObject(
  [in]  const BSTR       strObjectPath,
  [in]  long             lFlags,
  [in]  IWbemContext     *pCtx,
  [out] IWbemClassObject **ppObject,
  [out] IWbemCallResult  **ppCallResult
);

パラメーター

[in] strObjectPath

取得するオブジェクトのパス。 これが NULL の場合は、新しいクラスになる可能性がある空のオブジェクトが返されます。 詳細については、「クラスの作成」を参照してください。

[in] lFlags

次のフラグは、このメソッドの動作に影響します。

WBEM_FLAG_USE_AMENDED_QUALIFIERS

このフラグが設定されている場合、WMI は、現在の接続のロケールのローカライズされた名前空間に格納されている修正された修飾子を取得します。 設定されていない場合は、イミディエイト名前空間に格納されている修飾子のみが取得されます。

WBEM_FLAG_RETURN_WBEM_COMPLETE

このフラグにより、同期呼び出しになります。

WBEM_FLAG_RETURN_IMMEDIATELY

このフラグにより、これは半同期呼び出しになります。 ppCallResult パラメーターの有効なポインターを指定する必要があります。 詳細については、「メソッドの呼び出し」を参照してください。

WBEM_FLAG_DIRECT_READ

このフラグを指定すると、親クラスまたはサブクラスに関係なく、指定されたクラスのプロバイダーに直接アクセスできます。

[in] pCtx

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

[out] ppObject

NULL でない場合、オブジェクトが見つかった場合はオブジェクトを受け取ります。 返されるオブジェクトは正の参照カウントを持ちます。 オブジェクトが不要になった場合、呼び出し元は Release を 使用する必要があります。 エラーのすべての場合、このパラメーターは NULL を指すように設定されます。

[out] ppCallResult

NULL の場合、このパラメーターは使用されません。 lFlags パラメーターにWBEM_FLAG_RETURN_IMMEDIATELYが含まれている場合、この呼び出しはWBEM_S_NO_ERRORを使用して直ちにを返します。 ppCallResult パラメーターは、新しい IWbemCallResult オブジェクトへのポインターを受け取り、GetCallStatus メソッドを使用して結果を取得するためにポーリングできます。 呼び出し元は IWbemCallResult::GetResultObject を 呼び出して、使用可能になったときにオブジェクトを取得できます。

戻り値

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

失敗した場合は、COM 関数 GetErrorInfo から使用可能な情報を取得できます。

ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラー コードも返される可能性があります。

要件

   
サポートされている最小のクライアント Windows Vista
サポートされている最小のサーバー Windows Server 2008
対象プラットフォーム Windows
ヘッダー wbemcli.h (Wbemidl.h を含む)
Library Wbemuuid.lib
[DLL] Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll。Wmidcprv.dll;Wmipjobj.dll。Wmiprvsd.dll

関連項目

クラスの作成

WMI オブジェクトの場所の記述

IWbemCallResult

IWbemServices

IWbemServices::GetObjectAsync

エラー コードの取得