ADsEnumerateNext-Funktion (adshlp.h)
Die ADsEnumerateNext-Funktion listet eine angegebene Anzahl von Elementen aus der aktuellen Cursorposition des Enumerators auf. Wenn der Vorgang erfolgreich ist, gibt die Funktion den aufgezählten Satz von Elementen in einem Variantenarray zurück. Die Anzahl der zurückgegebenen Elemente kann kleiner als die angegebene Zahl sein.
Syntax
HRESULT ADsEnumerateNext(
[in] IEnumVARIANT *pEnumVariant,
[in] ULONG cElements,
[out] VARIANT *pvar,
[out] ULONG *pcElementsFetched
);
Parameter
[in] pEnumVariant
Typ: IEnumVARIANT*
Zeiger auf die IEnumVARIANT-Schnittstelle für das Enumeratorobjekt.
[in] cElements
Typ: ULONG
Anzahl der angeforderten Elemente.
[out] pvar
Typ: VARIANT*
Zeiger auf das Array der abgerufenen Elemente.
[out] pcElementsFetched
Typ: ULONG*
Die tatsächliche Anzahl der abgerufenen Elemente, die kleiner als die Anzahl der angeforderten Elemente sein kann.
Rückgabewert
Typ: HRESULT
Diese Methode unterstützt die Standardrückgabewerte.
Weitere Informationen zu anderen Rückgabewerten finden Sie unter ADSI-Fehlercodes.
Hinweise
Der allgemeine Prozess zum Aufzählen von Objekten in einem Container umfasst Folgendes:
Erstellen Sie zunächst ein Enumeratorobjekt für diesen Container.
Rufen Sie anschließend den IEnumVARIANT-Schnittstellenzeiger ab.
Rufen Sie drittens die ADsEnumerateNext-Funktion auf, um einen aufgezählten Satz von Elementen aus dem Enumeratorobjekt zurückzugeben.
Rufen Sie viertens die ADSFreeEnumerator-Funktion auf, um das Enumeratorobjekt frei zu geben.
Weitere Informationen und ein Codebeispiel finden Sie im Thema ADsBuildEnumerator .
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | adshlp.h |
| Bibliothek | Activeds.lib |
| DLL | Activeds.dll |