描述
IWbemConfigureRefresher.AddEnum方法将枚举器添加到请求的刷新器。
C++ 语法
HRESULT AddEnum( [in] IWbemServices *pNamespace, [in] LPCWSTR wszClassName, [in] long lFlags, [in] IWbemContext *pCtx, [out] IWbemHiPerfEnum **ppEnum, [out] long *plId ); |
PowerBASIC 语法
METHOD AddEnum ( _ BYVAL pNamespace AS IWbemServices, _ BYREF wszClassName AS WSTRINGZ, _ BYVAL lFlags AS LONG, _ BYVAL pCtx AS IWbemContext, _ BYREF ppEnum AS IWbemHiPerfEnum, _ BYREF plId AS LONG _ ) AS LONG |
参数
pNamespace
指向Windows Management的IWbemServices指针，可以为提供商提供的任何请求提供服务。如果该方法在执行期间必须回调到Windows Management，则提供者应使用pNamespace指针调用AddRef.
wszClassName
常量，以null结尾的16位Unicode字符串，包含枚举类的名称。
lFlags
修改此方法行为的标志位掩码。如果此参数设置为WBEM_FLAG_USE_AMENDED_QUALIFIERS，则返回的实例包含本地限定符（如果可用）。
pCtx
通常为NULL;否则，这是指向一个或多个动态类提供者所需的IWbemContext对象的指针。必须在特定提供者文档中指定上下文对象中的值。有关此参数的详细信息，请参阅拨打电话给WMI.
ppEnum
指针包含对IWbemHiPerfEnum对象的引用，该对象将包含枚举。客户端不再需要时，必须在此指针上调用Release。
plId
指向由提供程序返回的唯一标识可刷新枚举的整数的指针。
返回值
此方法返回一个HRESULT，指示方法调用的状态。下表列出了HRESULT中包含的值。
退货代码 |
描述 |
WBEM_E_INVALID_PARAMETER |
指定了无效参数。 |
WBEM_E_INVALID_CLASS |
指定的类无效。 |
WBEM_E_ACCESS_DENIED |
当前用户没有执行此操作的权限。 |
WBEM_E_INVALID_OPERATION |
请求的实例不是由高性能提供商提供的。 |
WBEM_E_REFRESHER_BUSY |
复习者忙于另一个操作。 |
WBEM_S_NO_ERROR |
操作成功。 |
备注
提供的类必须指定一个有效的类，由高性能提供者提供。调用后可以查询返回的枚举器的所有实例。在每次刷新调用时，枚举器中的实例数可能会有所不同。只返回指定类名的实例;指定类的子类不会被枚举，因为不支持深度枚举。当刷新操作正在进行时，返回的枚举器不能被客户端触及。返回的标识符可以由去掉函数用于删除对象。请注意，用户不需要显式删除添加的枚举器。但是，当不再需要时，客户端必须在返回的枚举器上调用发布.
要求
客户 |
需要Windows Vista，Windows XP，Windows 2000 Professional或Windows NT Workstation 4.0 SP4及更高版本。 |
服务器 |
需要Windows Server 2008，Windows Server 2003，Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。 |
头 |
在Wbemcli.inc中声明。 |
图书馆 |
使用Wbemuuid.lib。 |
DLL |
需要Wbemperf.dll。 |