ADsFreeEnumerator-Funktion (adshlp.h)

Die Funktion ADsFreeEnumerator gibt ein Enumeratorobjekt frei, das mit der Funktion ADsBuildEnumerator erstellt wurde.

Syntax

HRESULT ADsFreeEnumerator(
  [in] IEnumVARIANT *pEnumVariant
);

Parameter

[in] pEnumVariant

Typ: IEnumVARIANT*

Zeiger auf die IEnumVARIANT-Schnittstelle des freizugebenden Enumeratorobjekts.

Rückgabewert

Typ: HRESULT

Diese Methode unterstützt standardmäßige Rückgabewerte sowie folgendes.

Hinweise

Der allgemeine Prozess zum Auflisten von Objekten in einem Container sieht wie folgt aus.

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 unter 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

Weitere Informationen

ADSI-Fehlercodes

ADSI-Funktionen

ADsBuildEnumerator

ADsEnumerateNext

IEnumVARIANT