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 |