IWbemCallResult::GetResultString 方法 (wbemcli.h)

IWbemCallResult::GetResultString 方法會傳回 IWbemServices::P utInstance 新建立之實例的指派對象路徑。

注意 呼叫結果物件主要用於提供者執行 PutInstance 呼叫,而客戶端必須知道物件路徑, (指派提供者) 索引鍵屬性的值。 例如,如果類別索引鍵屬性是全域唯一標識符 (GUID) ,在 PutInstance 作業期間由提供者指派,除非提供者能夠以這種方式傳回它,否則用戶端將無法知道此 GUID。
 

語法

HRESULT GetResultString(
  [in]  long lTimeout,
  [out] BSTR *pstrResultString
);

參數

[in] lTimeout

指定這個呼叫在傳回之前封鎖的最大時間,以毫秒為單位。 如果您使用常數 WBEM_INFINITE (0xFFFFFFFF) ,呼叫會封鎖直到物件路徑可用為止。 如果您使用 0,呼叫會立即傳回物件路徑或狀態代碼。

[out] pstrResultString

不可以是 NULL。 此參數會接收物件路徑的指標,進而導致新建立的物件。 傳回的字串必須使用系統呼叫 SysFreeString 解除分配。 發生錯誤時,不會傳回新的字串。

傳回值

這個方法會傳回 HRESULT ,指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

發生錯誤時,您可以呼叫 COM 函式 GetErrorInfo 以取得更多錯誤資訊。

如果網路問題造成您失去 Windows 管理遠端連線,也可能傳回 COM 特定的錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows Vista
最低支援的伺服器 Windows Server 2008
目標平台 Windows
標頭 wbemcli.h (包含 Wbemidl.h)

另請參閱

IWbemCallResult

IWbemServices::P utInstance