Funzione ADsEnumerateNext (adshlp.h)
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 |