描述
IWbemCallResult.GetResultObject方法尝试从上一次的半同步调用IWbemServices.GetObject或IWbemServices.ExecMethod中检索对象。如果对象不可用,则调用返回WBEM_S_TIMEDOUT。此外,在调用此方法获取结果对象之前,可以调用IWbemCallResult.GetCallStatus直到返回WBEM_S_NO_ERROR,表示原始的半同步操作已完成。
C++ 语法
HRESULT GetResultObject( [in] LONG lTimeout, [out] IWbemClassObject **ppResultObject ); |
PowerBASIC 语法
METHOD GetResultObject ( _ BYVAL lTimeout AS LONG, _ BYREF ppResultObject AS IWbemClassObject _ ) AS LONG |
参数
lTimeout
指定此调用在返回之前阻塞的最大时间(以毫秒为单位)。如果使用常量WBEM_INFINITE(0xFFFFFFFF),调用将阻塞,直到该对象可用。如果使用0,则调用立即返回对象或状态代码。
ppResultObject
此参数不能为NULL。它在可用时接收对象的副本。当不再需要对象时,必须在返回的对象上调用IWbemClassObject.Release.错误时不返回新对象。
返回值
此方法返回一个HRESULT,指示方法调用的状态。下表列出了HRESULT内包含的值。
如果原始的半异步操作失败(例如当没有找到对象或者该方法不能被调用时),则该方法返回原始函数在其同步版本中返回的错误代码。
出现错误时,可以调用COM函数GetErrorInfo获取更多错误信息。
如果网络问题导致您失去与Windows Management的远程连接,也可能会返回COM特定的错误代码。
退货代码 |
描述 |
WBEM_S_NO_ERROR |
该对象成功返回。 |
WBEM_S_TIMEDOUT |
该对象在lTimeout值过期之前尚未可用。 |
WBEM_E_UNEXPECTED |
通话失败,预计不会完成。 |
WBEM_E_TRANSPORT_FAILURE |
这表示当前进程和Windows Management之间的远程过程调用(RPC)链接失败。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
要求
客户 |
需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。 |
服务器 |
需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |