Función ADsEnumerateNext (adshlp.h)
La función ADsEnumerateNext enumera a través de un número especificado de elementos de la posición actual del cursor del enumerador. Cuando la operación se realiza correctamente, la función devuelve el conjunto enumerado de elementos de una matriz variant. El número de elementos devueltos puede ser menor que el número especificado.
Sintaxis
HRESULT ADsEnumerateNext(
[in] IEnumVARIANT *pEnumVariant,
[in] ULONG cElements,
[out] VARIANT *pvar,
[out] ULONG *pcElementsFetched
);
Parámetros
[in] pEnumVariant
Tipo: IEnumVARIANT*
Puntero a la interfaz IEnumVARIANT en el objeto enumerador.
[in] cElements
Tipo: ULONG
Número de elementos solicitados.
[out] pvar
Tipo: VARIANT*
Puntero a la matriz de elementos recuperados.
[out] pcElementsFetched
Tipo: ULONG*
Número real de elementos recuperados, que pueden ser menores que el número de elementos solicitados.
Valor devuelto
Tipo: HRESULT
Este método admite los valores devueltos estándar.
Para obtener más información sobre otros valores devueltos, consulta Códigos de error ADSI.
Comentarios
El proceso general para enumerar objetos de un contenedor implica lo siguiente:
En primer lugar, cree un objeto de enumerador en ese contenedor.
En segundo lugar, recupere el puntero de interfaz IEnumVARIANT .
En tercer lugar, llame a la función ADsEnumerateNext para devolver un conjunto enumerado de elementos del objeto enumerador.
En cuarto lugar, llame a la función ADSFreeEnumerator para liberar el objeto enumerador.
Para obtener más información y un ejemplo de código, vea el tema ADsBuildEnumerator .
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | adshlp.h |
| Library | Activeds.lib |
| Archivo DLL | Activeds.dll |