Compartilhar via


Função ADsEnumerateNext (adshlp.h)

A função ADsEnumerateNext enumera por meio de um número especificado de elementos da posição atual do cursor do enumerador. Quando a operação é bem-sucedida, a função retorna o conjunto enumerado de elementos em uma matriz variante. O número de elementos retornados pode ser menor que o número especificado.

Sintaxe

HRESULT ADsEnumerateNext(
  [in]  IEnumVARIANT *pEnumVariant,
  [in]  ULONG        cElements,
  [out] VARIANT      *pvar,
  [out] ULONG        *pcElementsFetched
);

Parâmetros

[in] pEnumVariant

Tipo: IEnumVARIANT*

Ponteiro para a interface IEnumVARIANT no objeto enumerador.

[in] cElements

Tipo: ULONG

Número de elementos solicitados.

[out] pvar

Tipo: VARIANT*

Ponteiro para a matriz de elementos recuperados.

[out] pcElementsFetched

Tipo: ULONG*

Número real de elementos recuperados, que podem ser menores do que o número de elementos solicitados.

Retornar valor

Tipo: HRESULT

Esse método dá suporte aos valores retornados padrão.

Para obter mais informações sobre outros valores retornados, consulte Códigos de erro ADSI.

Comentários

O processo geral para enumerar objetos em um contêiner envolve o seguinte:

Primeiro, crie um objeto enumerador nesse contêiner.

Em segundo lugar, recupere o ponteiro da interface IEnumVARIANT .

Em terceiro lugar, chame a função ADsEnumerateNext para retornar um conjunto enumerado de elementos do objeto enumerador.

Em quarto lugar, chame a função ADSFreeEnumerator para liberar o objeto enumerador.

Para obter mais informações e um exemplo de código, consulte o tópico ADsBuildEnumerator .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho adshlp.h
Biblioteca Activeds.lib
DLL Activeds.dll

Confira também

Códigos de erro ADSI

Funções ADSI

ADsBuildEnumerator

ADsFreeEnumerator

FreeADsMem

IEnumVARIANT