IWbemCallResult::GetResultString メソッド (wbemcli.h)
IWbemCallResult::GetResultString メソッドは、IWbemServices::P utInstance によって新しく作成されたインスタンスの割り当てられたオブジェクト パスを返します。
メモ 呼び出し結果オブジェクトは、 PutInstance 呼び出しがプロバイダーによって実行され、クライアントがプロバイダーに割り当てられたオブジェクト パス (キー プロパティの値) を認識する必要がある場合に主に使用されます。 たとえば、クラス キー プロパティがグローバル一意識別子 (GUID) である場合、 PutInstance 操作中にプロバイダーによって割り当てられると、プロバイダーがこの GUID をこの方法で返すことができる場合を除き、クライアントはこの GUID を認識できません。
構文
HRESULT GetResultString(
[in] long lTimeout,
[out] BSTR *pstrResultString
);
パラメーター
[in] lTimeout
この呼び出しが戻るまでにブロックする最大時間をミリ秒単位で指定します。 定数 WBEM_INFINITE (0xFFFFFFFF) を使用すると、オブジェクト パスが使用可能になるまで呼び出しがブロックされます。 0 を使用すると、呼び出しはオブジェクト パスまたは状態コードをすぐに返します。
[out] pstrResultString
NULL にすることはできません。 このパラメーターは、オブジェクト パスへのポインターを受け取ります。これにより、新しく作成されたオブジェクトが作成されます。 返される文字列は、システム呼び出し SysFreeString を使用して割り当てを解除する必要があります。 エラーが発生した場合、新しい文字列は返されません。
戻り値
このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。 次の一覧は、 HRESULT に含まれる値の一覧です。
エラーが発生した場合は、COM 関数 GetErrorInfo を呼び出して、より多くのエラー情報を取得できます。
ネットワークの問題によって Windows Management へのリモート接続が失われる場合は、COM 固有のエラー コードも返される可能性があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows Vista |
| サポートされている最小のサーバー | Windows Server 2008 |
| 対象プラットフォーム | Windows |
| ヘッダー | wbemcli.h (Wbemidl.h を含む) |