Sammlungen und Gruppen

ADSI verwendet Sammlungsobjekte, um beliebige Elemente in einem Verzeichnisdienst darzustellen, die mit demselben Datentyp dargestellt werden können. Auflistungsobjekte werden als Satz von VARIANT- Werten definiert, die einen der gültigen Automatisierungsdatentypen darstellen. Sammlungsobjekte können sowohl persistente Informationen wie Zugriffssteuerungslisten als auch veränderliche Informationen wie Druckaufträge in einer Druckwarteschlange darstellen.

Die STANDARDMÄßIGe COM-Konvention zum Auflisten des Inhalts eines Auflistungsobjekts (oder Containerobjekts) besteht darin, ein Enumerationsobjekt zu erstellen, das IEnumVARIANTunterstützt, das Methoden zum Durchlaufen der Liste der Auflistungsobjekte enthält. Die Schnittstellen in ADSI, die die get__NewEnum-Methode bereitstellen (beachten Sie die beiden Unterstriche), sind IADsContainer, IADsMembers und IADsCollection. ADSI stellt außerdem die Hilfsfunktionen ADsBuildEnumerator und ADsEnumerateNext- für C- und C++-Programme bereit, um die Enumeration zu vereinfachen. Automatisierungsclients verwenden die Enumeration implizit, wenn sie Next in einer For Schleife aufrufen.

Gruppen sind einfach Auflistungen von Objekten, die die IADsMembers Schnittstelle unterstützen.