Función ADsEnumerateNext (adshlp.h)

Artículo
02/23/2024

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