IWbemConfigureRefresher：：AddEnum 方法 (wbemcli.h)

IWbemConfigureRefresher：：AddEnum 方法将枚举器添加到请求的刷新程序。

语法

HRESULT AddEnum(
  [in]  IWbemServices   *pNamespace,
  [in]  LPCWSTR         wszClassName,
  [in]  long            lFlags,
  [in]  IWbemContext    *pContext,
  [out] IWbemHiPerfEnum **ppEnum,
  [out] long            *plId
);

参数

[in] pNamespace

IWbemServices 指针返回到 Windows 管理，它可以为提供程序发出的任何请求提供服务。 如果方法在执行过程中必须调用回 Windows 管理，则提供程序应使用 pNamespace 指针调用 AddRef。

[in] wszClassName

包含枚举类名称的 16 位 Unicode 字符的常量、以 null 结尾的字符串。

[in] lFlags

修改此方法行为的标志的位掩码。 如果此参数设置为 WBEM_FLAG_USE_AMENDED_QUALIFIERS，则返回的实例包含本地化限定符（如果可用）。

[in] pContext

通常 为 NULL;否则，这是指向一个或多个动态类提供程序所需的 IWbemContext 对象的指针。 必须在特定的提供程序文档中指定上下文对象中的值。 有关此参数的详细信息，请参阅 调用 WMI。

[out] ppEnum

保存对 IWbemHiPerfEnum 对象的引用的指针，该对象将包含枚举。 当不再需要时，客户端必须对此指针调用 Release 。

[out] plId

指向提供程序返回的整数的指针，该整数唯一标识可刷新枚举。

返回值

此方法返回指示方法调用状态的 HRESULT。 以下列表列出了 包含在 中的值

注释HRESULT

 

.

注解

提供的类必须指定有效的类，该类由 High-Performance 提供程序提供。 调用后，可以查询返回的枚举器的所有实例。 每次调用刷新时，枚举器中的实例数可能会有所不同。 仅返回指定类名的实例;由于不支持详细枚举，因此不会枚举指定类的子类。 当 刷新 操作正在进行时，客户端不得触摸返回的枚举器。 Remove 函数可以使用返回的标识符来删除对象。 请注意，用户无需显式删除添加的枚举器。 但是，当不再需要时，客户端必须对返回的枚举器调用 Release 。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	wbemcli.h (包括 Wbemidl.h)
Library	Wbemuuid.lib

另请参阅

IWbemConfigureRefresher