IWSManSession：：Enumerate 方法 (wsmandisp.h)
枚举表、数据收集或日志资源。 若要创建查询，请在枚举中包含 筛选器 参数和 方言 参数。 还可以使用 IWSManResourceLocator 对象创建查询。 有关详细信息，请参阅 枚举或列出资源的所有实例。
语法
HRESULT Enumerate(
[in] VARIANT resourceUri,
[in, optional] BSTR filter,
[in, optional] BSTR dialect,
[in] long flags,
[out] IDispatch **resultSet
);
参数
[in] resourceUri
要检索的资源的标识符。
以下列表包含此参数可以包含的标识符：
- 具有一个或多个 选择器的 URI。 调用 Enumerate 方法以获取 WMI 资源时，请使用 对象的键属性。
- 可以使用 选择器、 片段或 选项。 有关详细信息，请参阅 IWSManResourceLocator。
- WS 寻址 终结点引用，如 WS-Management 协议标准中所述。 有关 WS-Management 协议的公共规范的详细信息，请参阅 管理规范索引页。
[in, optional] filter
一个筛选器，用于定义枚举返回的资源中的项。 枚举资源时，仅返回与筛选条件匹配的项。 在枚举中包含 筛选器 参数和 方言 参数会将枚举转换为查询。
如果有 resourceURI 参数的 IWSManResourceLocator 对象，则不应使用此参数。 请改用 IWSManResourceLocator 的选择器和片段功能。
[in, optional] dialect
筛选器使用的语言。 WQL 是 WMI 使用的 SQL 的子集，是唯一支持的语言。
如果有 resourceURI 参数的 IWSManResourceLocator 对象，则不应使用此参数。 请改用 IWSManResourceLocator 的选择器和片段功能。
[in] flags
此参数必须包含 __WSManEnumFlags 枚举中的标志。 有关详细信息，请参阅 枚举常量。
[out] resultSet
包含枚举结果的 IWSManEnumerator 对象。
返回值
如果该方法成功，则返回 S_OK。 否则，将返回 HRESULT 错误代码。
注解
调用 IWSManSession：：Enumerate 以启动枚举操作。 此后，使用返回的 IWSManEnumerator 对象调用 IWSManEnumerator：：ReadItem，直到 AtEndOfStream 属性指示项的末尾。
请注意，如果标志包含 枚举常量WSManFlagHierarchyDeepBasePropsOnly 或 WSManFlagHierarchyShallow ，则 Windows 远程管理服务 ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED返回错误代码。
有关在枚举期间限制网络调用的详细信息，请参阅 BatchItems 属性。
如果指定了筛选器，则它必须是与资源架构相关的有效文档。 方言参数是可选的。 但是，如果筛选器字符串以 <开头，但不是 XML 片段，则要么包括 dialect 参数，要么在 flags 参数中设置 WSManFlagNonXmlText 标志。 有关详细信息，请参阅 枚举常量。
相应的脚本方法为 Session.Enumerate。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | wsmandisp.h |
| Library | WSManDisp.tlb |
| DLL | WSMAuto.dll |