Метод IWSManSession::Enumerate (wsmandisp.h)

Статья
08/28/2023

Перечисляет таблицу, коллекцию данных или ресурс журнала. Чтобы создать запрос, включите параметр фильтра и параметр диалекта в перечисление. Для создания запросов также можно использовать объект 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, является единственным поддерживаемым языком.

[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

См. также раздел

IWSManEnumerator

IWSManSession

Session.Enumerate