通过

CWbemProviderGlue：：GetInstancesByQuery (LPCWSTR，TRefPointerCollection<CInstance>*，MethodContext*，LPCWSTR) method (wbemglue.h)

  • 项目

[CWbemProviderGlue 类是 WMI 提供程序框架的一部分，现在视为处于最终状态，对于影响这些库的非安全性相关问题，将不会提供进一步的开发、增强或更新。 所有新开发均应使用 MI API。]

GetInstancesByQuery 方法检索与特定查询匹配的实例列表。

语法

HRESULT GetInstancesByQuery(
  LPCWSTR                          query,
  TRefPointerCollection<CInstance> *pList,
  MethodContext                    *pMethodContext,
  LPCWSTR                          pszNamespace
);

参数

query

要执行的查询。

pList

与 Query 指定的查询匹配的实例的链接列表。

pMethodContext

指向当前上下文的指针。 必须提供上下文以防止死锁。 使用由 Provider：：EnumerateInstances 或 Provider：：ExecQuery 传入提供程序的上下文，或使用 CInstance：：GetMethodContext 从实例获取上下文。 此参数不得为 NULL。

pszNamespace

指向包含实例的命名空间的指针。 如果 为 NULL，则使用默认命名空间 root\cimv2。

返回值

如果操作成功，该方法将返回WBEM_S_NO_ERROR，WBEM_E_FAILED如果操作失败，则返回任何其他 HRESULT 错误代码。

注解

GetInstancesByQuery 方法允许框架提供程序访问来自其他提供程序的数据，而无需进行 WMI API 调用。 框架提供程序将查询传递给 GetInstancesByQuery，后者返回相应的实例。

出于性能原因，调用此函数时，仅指定 (所需的属性，例如，指定“SELECT name”而不是“SELECT *”) 。

要求

要求 值
最低受支持的客户端 Windows Vista
最低受支持的服务器 Windows Server 2008
目标平台 Windows
标头 wbemglue.h (包括 FwCommon.h)
Library FrameDyn.lib
DLL FrameDynOS.dll;FrameDyn.dll