IWbemCallResult::GetResultObject メソッド (wbemcli.h)

IWbemCallResult::GetResultObject メソッドは、IWbemServices::GetObject または IWbemServices::ExecMethod に対する以前の半同期呼び出しからオブジェクトを取得しようとします。 オブジェクトがまだ使用できない場合、呼び出しは WBEM_S_TIMEDOUTを返します。 また、このメソッドを呼び出して結果のオブジェクトを取得する前に、WBEM_S_NO_ERRORを返すまで IWbemCallResult::GetCallStatus を呼び出 し、元の半同期操作が完了したことを示します。

構文

HRESULT GetResultObject(
  [in]  long             lTimeout,
  [out] IWbemClassObject **ppResultObject
);

パラメーター

[in] lTimeout

この呼び出しが返されるまでの最大時間をミリ秒単位で指定します。 定数 WBEM_INFINITE (0xFFFFFFFF) を使用すると、オブジェクトが使用可能になるまで呼び出しはブロックされます。 0 を使用すると、呼び出しはオブジェクトまたは状態コードをすぐに返します。

[out] ppResultObject

このパラメーターを NULL にすることはできません。 使用可能になると、オブジェクトのコピーを受け取ります。 オブジェクトが不要になった場合は、返されたオブジェクトで IWbemClassObject::Release を呼び出す必要があります。 エラーが発生した場合、新しいオブジェクトは返されません。

戻り値

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

元の半同期操作が失敗した場合 (オブジェクトが見つからない場合やメソッドを呼び出すことができなかった場合など)、このメソッドは、元の関数が同期バージョンで返したエラー コードを返します。

エラーが発生した場合は、COM 関数 GetErrorInfo を呼び出して、より多くのエラー情報を取得できます。

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

要件

サポートされている最小のクライアント	Windows Vista
サポートされている最小のサーバー	Windows Server 2008
対象プラットフォーム	Windows
ヘッダー	wbemcli.h (Wbemidl.h を含む)

関連項目

IWbemCallResult

IWbemServices::ExecMethod

IWbemServices::GetObject