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