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 |