Поделиться через


Метод 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

Идентификатор извлекаемого ресурса.

В следующем списке содержатся идентификаторы, которые может содержать этот параметр:

[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

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

IWSManEnumerator

IWSManSession

Session.Enumerate