Compartir a través de


Método IWSManSession::Enumerate (wsmandisp.h)

Enumera una tabla, una colección de datos o un recurso de registro. Para crear una consulta, incluya un parámetro de filtro y un parámetro dialecto en una enumeración. También puede usar un objeto IWSManResourceLocator para crear consultas. Para obtener más información, vea Enumerar o enumerar todas las instancias de un recurso.

Sintaxis

HRESULT Enumerate(
  [in]           VARIANT   resourceUri,
  [in, optional] BSTR      filter,
  [in, optional] BSTR      dialect,
  [in]           long      flags,
  [out]          IDispatch **resultSet
);

Parámetros

[in] resourceUri

Identificador del recurso que se va a recuperar.

La lista siguiente contiene identificadores que este parámetro puede contener:

[in, optional] filter

Filtro que define qué elementos del recurso devuelve la enumeración . Cuando se enumera el recurso, solo se devuelven los elementos que coinciden con los criterios de filtro. La inclusión de un parámetro de filtro y un parámetro dialecto en una enumeración convierte la enumeración en una consulta.

Si tiene un objeto IWSManResourceLocator para el parámetro resourceURI , no se debe usar este parámetro. En su lugar, use la funcionalidad de selector y fragmento de IWSManResourceLocator.

[in, optional] dialect

Idioma utilizado por el filtro. WQL, un subconjunto de SQL usado por WMI, es el único lenguaje admitido.

Si tiene un objeto IWSManResourceLocator para el parámetro resourceURI , no se debe usar este parámetro. En su lugar, use la funcionalidad de selector y fragmento de IWSManResourceLocator.

[in] flags

Este parámetro debe contener una marca en la enumeración __WSManEnumFlags . Para obtener más información, vea Constantes de enumeración.

[out] resultSet

Objeto IWSManEnumerator que contiene los resultados de la enumeración.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Llame a IWSManSession::Enumerate para iniciar una operación de enumeración. A partir de entonces, llame a IWSManEnumerator::ReadItem mediante el objeto IWSManEnumerator devuelto hasta que el final de los elementos se indique mediante la propiedad AtEndOfStream .

Tenga en cuenta que si las marcas incluyen las constantes de enumeraciónWSManFlagHierarchyDeepBasePropsOnly o WSManFlagHierarchyShallow , el servicio administración remota de Windows devuelve el código de error ERROR_WSMAN_POLYMORPHISM_MODE_UNSUPPORTED.

Para obtener más información sobre cómo limitar las llamadas de red durante una enumeración, consulte la propiedad BatchItems .

Si se especifica un filtro, debe ser un documento válido con respecto al esquema del recurso. El parámetro dialecto es opcional. Sin embargo, si la cadena de filtro comienza por <, pero no es un fragmento XML, incluya el parámetro dialecto o establezca la marca WSManFlagNonXmlText en el parámetro flags . Para obtener más información, vea Constantes de enumeración.

El método de scripting correspondiente es Session.Enumerate.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista
Servidor mínimo compatible Windows Server 2008
Plataforma de destino Windows
Encabezado wsmandisp.h
Library WSManDisp.tlb
Archivo DLL WSMAuto.dll

Consulte también

IWSManEnumerator

IWSManSession

Session.Enumerate