Метод 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-Addressing, как описано в стандарте протокола WS-Management. Дополнительные сведения об общедоступной спецификации для протокола WS-Management см. на странице Индекс спецификаций управления.
[in, optional] filter
Фильтр, определяющий, какие элементы ресурса возвращаются перечислением . При перечислении ресурса возвращаются только те элементы, которые соответствуют критериям фильтра. Включение параметра фильтра и параметра диалекта в перечисление преобразует перечисление в запрос.
Если у вас есть объект IWSManResourceLocator для параметра resourceURI , этот параметр использовать не следует. Вместо этого используйте функции селектора и фрагмента IWSManResourceLocator.
[in, optional] dialect
Язык, используемый фильтром. WQL, подмножество SQL, используемое WMI, является единственным поддерживаемым языком.
Если у вас есть объект IWSManResourceLocator для параметра resourceURI , этот параметр использовать не следует. Вместо этого используйте функции селектора и фрагмента IWSManResourceLocator.
[in] flags
Этот параметр должен содержать флаг в перечислении __WSManEnumFlags . Дополнительные сведения см. в разделе Константы перечисления.
[out] resultSet
Объект IWSManEnumerator , содержащий результаты перечисления.
Возвращаемое значение
Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Вызовите IWSManSession::Enumerate , чтобы запустить операцию перечисления. После этого вызовите IWSManEnumerator::ReadItem , используя возвращенный объект IWSManEnumerator , пока конец элементов не будет обозначен свойством AtEndOfStream .
Имейте в виду, что если флаги включают константы перечисленияWSManFlagHierarchyDeepBasePropsOnly или WSManFlagHierarchyShallow , то служба удаленного управления Windows возвращает код ошибки ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.
Дополнительные сведения об ограничении сетевых вызовов во время перечисления см. в свойстве BatchItems .
Если указан фильтр, он должен быть допустимым документом по отношению к схеме ресурса. Параметр диалекта является необязательным. Однако если строка фильтра начинается с <, но не является фрагментом XML, включите параметр диалекта или задайте флаг WSManFlagNonXmlText в параметре flags . Дополнительные сведения см. в разделе Константы перечисления.
Соответствующий метод скрипта — Session.Enumerate.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | wsmandisp.h |
| Библиотека | WSManDisp.tlb |
| DLL | WSMAuto.dll |