描述
IWbemCallResult.GetResultString方法返回由IWbemServices.PutInstance新创建的实例的分配对象路径。
注意当PutInstance调用由提供者执行时,主要使用调用结果对象,并且客户端需要知道分配给提供程序的对象路径(关键属性的值)。例如,如果类密钥属性是PutInstance操作期间由提供商分配的全局唯一标识符(GUID),则客户端将无法知道此GUID,除非提供程序能够以此方式返回。
C++ 语法
HRESULT GetResultString( [in] LONG lTimeout, [out] BSTR *pstrResultString ); |
PowerBASIC 语法
METHOD GetResultString ( _ BYVAL lTimeout AS LONG, _ BYREF pstrResultString AS WSTRING _ ) AS LONG |
参数
lTimeout
指定此调用在返回之前阻塞的最大时间(以毫秒为单位)。如果使用常量WBEM_INFINITE(0xFFFFFFFF),调用将阻塞,直到对象路径可用。如果使用0,则立即返回对象路径或状态码。
pstrResultString
不能为空。该参数接收对象路径,这又导致新创建的对象。出错时,不会返回新的字符串。
返回值
此方法返回一个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_ACCESS_DENIED |
来电者尝试未经授权的操作。 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_OUT_OF_MEMORY |
没有足够的内存来完成操作。 |
WBEM_E_FAILED |
发生未指定的错误。 |
要求
客户 |
需要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中声明。 |