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_ERRORppCallResult 参数接收指向新的 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

另请参阅

创建类

描述 WMI 对象的位置

IWbemCallResult

IWbemServices

IWbemServices::GetObjectAsync

检索错误代码