IWbemServices::GetObject 方法 (wbemcli.h)
IWbemServices::GetObject 方法检索类或实例。 此方法仅从与当前 IWbemServices 对象关联的命名空间中检索对象。
语法
HRESULT GetObject(
[in] const BSTR strObjectPath,
[in] long lFlags,
[in] IWbemContext *pCtx,
[out] IWbemClassObject **ppObject,
[out] IWbemCallResult **ppCallResult
);
参数
[in] strObjectPath
要检索的对象的路径。 如果为 NULL,则返回一个空对象,该对象可以成为新类。 有关详细信息,请参阅创建类。
[in] lFlags
以下标志影响此方法的行为。
WBEM_FLAG_USE_AMENDED_QUALIFIERS
如果设置了此标志,WMI 将检索存储在当前连接区域设置的本地化命名空间中的修改后的限定符。 如果未设置,则仅检索存储在直接命名空间中的限定符。
WBEM_FLAG_RETURN_WBEM_COMPLETE
此标志使其成为同步调用。
WBEM_FLAG_RETURN_IMMEDIATELY
此标志使其成为半同步调用。 必须为 ppCallResult 参数提供有效的指针。 有关详细信息,请参阅调用方法。
WBEM_FLAG_DIRECT_READ
此标志导致直接访问指定的类的提供程序,而不考虑其父类或子类。
[in] pCtx
通常 为 NULL。 否则,这是指向 IWbemContext 对象的指针,生成所请求的类或实例的提供程序可以使用该对象。 上下文对象中的值必须在相关提供程序的文档中指定。 有关此参数的详细信息,请参阅 调用 WMI。
[out] ppObject
如果不是 NULL,则它接收对象(如果找到)。 返回的对象具有正引用计数。 当不再需要对象时,调用方必须使用 Release 。 在所有错误情况下,此参数都设置为指向 NULL。
[out] ppCallResult
如果 为 NULL,则不使用此参数。 如果 lFlags 参数包含 WBEM_FLAG_RETURN_IMMEDIATELY,此调用将立即返回 并WBEM_S_NO_ERROR。 ppCallResult 参数接收指向新的 IWbemCallResult 对象的指针,然后可以使用 GetCallStatus 方法轮询该对象以获取结果。 调用方可以调用 IWbemCallResult::GetResultObject ,以在对象可用时检索该对象。
返回值
此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 HRESULT 中包含的值。
如果失败,可以从 COM 函数 GetErrorInfo 获取任何可用信息。
如果网络问题导致你失去与 Windows 管理的远程连接,也可能会返回特定于 COM 的错误代码。
要求
最低受支持的客户端 | Windows Vista |
最低受支持的服务器 | Windows Server 2008 |
目标平台 | Windows |
标头 | wbemcli.h (包括 Wbemidl.h) |
Library | Wbemuuid.lib |
DLL | Fastprox.dll;Esscli.dll;FrameDyn.dll;FrameDynOS.dll;Ntevt.dll;Stdprov.dll;Viewprov.dll;Wbemcomn.dll;Wbemcore.dll;Wbemess.dll;Wbemsvc.dll;Wmipicmp.dll;Wmidcprv.dll;Wmipjobj.dll;Wmiprvsd.dll |