IWbemCallResult::GetCallStatus メソッド (wbemcli.h)
IWbemCallResult::GetCallStatus メソッドは、現在未処理の半同期呼び出しの状態をユーザーに返します。 この呼び出しが WBEM_S_NO_ERRORを返すと、 IWbemServices メソッドの元の呼び出しが完了します。
構文
HRESULT GetCallStatus(
[in] long lTimeout,
[out] long *plStatus
);
パラメーター
[in] lTimeout
この呼び出しが返されるまでの最大時間をミリ秒単位で指定します。 定数 WBEM_INFINITE (0xFFFFFFFF) を使用すると、 IWbemServices メソッドの元の半同期呼び出しが完了するまで呼び出しはブロックされます。 0 (ゼロ) を使用すると、呼び出しはすぐに呼び出しの状態を返します。
[out] plStatus
WBEM_S_NO_ERRORがこのメソッドに HRESULT で戻った場合、このパラメーターは、OpenNamespace、PutInstance、PutClass、GetObject、DeleteInstance、DeleteClass、または ExecMethod のいずれかの IWbemServices メソッドの呼び出しの最終的な結果の状態を受け取ります。 エラーが発生した場合、 plStatus が指す値は使用されません。
戻り値
このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT 内に含まれる値の一覧です。
解説
エラーが発生した場合は、COM 関数 GetErrorInfo を呼び出して、より多くのエラー情報を取得できます。 ネットワークの問題によって Windows Management へのリモート接続が失われると、COM 固有のエラー コードが返される場合もあります。
IWbemServices メソッドを半同期的に呼び出した後、GetCallStatus をいつでも呼び出して、呼び出しが完了したかどうかを判断できます。 GetCallStatus が元の IWbemServices 操作の完了を示すWBEM_S_NO_ERRORを返した後、次の規則に従って、呼び出しの結果を取得するために他の IWbemCallResult メソッドの呼び出しが必要になる場合があります。
- IWbemServices::OpenNamespace の場合、新しい IWbemServices ポインターを取得するには、GetResultServices メソッドを呼び出す必要があります。
- IWbemServices::P utInstance の場合、GetResultString メソッドを呼び出して、オブジェクトに割り当てられたオブジェクト パスを取得する必要があります。
- IWbemServices::GetObject の場合、オブジェクトを取得するには GetResultObject メソッドを呼び出す必要があります。
- IWbemServices メソッド DeleteInstance、DeleteClass、ExecMethod の場合、GetCallStatus メソッドは、これらの操作に関する情報を返す唯一の呼び出しです。
要件
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemcli.h (Wbemidl.h を含む) |