CWbemProviderGlue::GetAllInstances 方法 (wbemglue.h)

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

GetAllInstances 方法检索特定类返回的实例列表。

语法

HRESULT GetAllInstances(
  LPCWSTR                          pszClassName,
  TRefPointerCollection<CInstance> *pList,
  LPCWSTR                          pszNamespace,
  MethodContext                    *pMethodContext
);

参数

pszClassName

应为其返回实例列表的类的名称。

pList

pszClassName 指定的提供程序支持的实例的链接列表。

pszNamespace

pszClassName 指定的提供程序的命名空间。 此参数可以为 NULL 以指示默认命名空间,即“Root\CIMv2”。

pMethodContext

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

返回值

如果操作成功,方法将返回WBEM_S_NO_ERROR,WBEM_E_OUT_OF_MEMORY如果操作因内存不足而失败,则返回任何其他 HRESULT 错误代码。

注解

GetAllInstances 方法允许框架提供程序从另一个提供程序访问数据,而无需进行 WMI API 调用。 框架提供程序将提供程序的名称传递给 GetAllInstances,这将返回提供程序支持的所有实例的列表。

此方法在语义上等效于查询 SELECT * FROM pszBaseClassName WHERE __Class = pszBaseClassName

要求

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