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) |