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 |