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