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:

• URI con uno o varios selectores. Al llamar al método Enumerate para obtener un recurso WMI, use la propiedad de clave o las propiedades del objeto .
• Puede usar selectores, fragmentos o opciones. Para obtener más información, vea IWSManResourceLocator.
• Referencia del punto de conexión WS-Addressing tal y como se describe en el estándar de protocolo WS-Management. Para obtener más información sobre la especificación pública del protocolo WS-Management, consulte la página Índice de especificaciones de administración.

[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