Funzione ADsEnumerateNext (adshlp.h)

Articolo
02/26/2024

La funzione ADsEnumerateNext enumera tramite un numero specificato di elementi dalla posizione corrente del cursore dell'enumeratore. Al termine dell'operazione, la funzione restituisce il set enumerato di elementi in una matrice variante. Il numero di elementi restituiti può essere minore del numero specificato.

Sintassi

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

Parametri

[in] pEnumVariant

Tipo: IEnumVARIANT*

Puntatore all'interfaccia IEnumVARIANT nell'oggetto enumeratore.

[in] cElements

Tipo: ULONG

Numero di elementi richiesti.

[out] pvar

Tipo: VARIANT*

Puntatore alla matrice di elementi recuperati.

[out] pcElementsFetched

Tipo: ULONG*

Numero effettivo di elementi recuperati, che possono essere inferiori al numero di elementi richiesti.

Valore restituito

Tipo: HRESULT

Questo metodo supporta i valori restituiti standard.

Per altre informazioni sugli altri valori restituiti, vedere Codici di errore ADSI.

Commenti

Il processo generale per enumerare gli oggetti in un contenitore implica quanto segue:

Creare prima di tutto un oggetto enumeratore in tale contenitore.

In secondo luogo, recuperare il puntatore dell'interfaccia IEnumVARIANT .

In terzo luogo, chiamare la funzione ADsEnumerateNext per restituire un set enumerato di elementi dall'oggetto enumeratore.

In quarto luogo, chiamare la funzione ADSFreeEnumerator per liberare l'oggetto enumeratore.

Per altre informazioni e un esempio di codice, vedere l'argomento ADsBuildEnumerator .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	adshlp.h
Libreria	Activeds.lib
DLL	Activeds.dll