ADsEnumerateNext-Funktion (adshlp.h)

Artikel
02/23/2024

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