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

Weitere Informationen

ADSI-Fehlercodes

ADSI-Funktionen

ADsBuildEnumerator

ADsFreeEnumerator

FreeADsMem

IEnumVARIANT