IADsCollection-Schnittstelle (iads.h)
Die IADsCollection-Schnittstelle ist eine duale Schnittstelle, mit der das HOST-ADSI-Objekt einen beliebigen Satz benannter Datenelemente für einen Verzeichnisdienst definieren und verwalten kann. Auflistungen unterscheiden sich von Arrays von Elementen darin, dass einzelne Elemente hinzugefügt oder gelöscht werden können, ohne das gesamte Array neu anzuordnen.
Sammlungsobjekte können ein oder mehrere Elemente darstellen, die flüchtigen Daten entsprechen, z. B. Prozesse oder aktive Kommunikationssitzungen, sowie persistente Daten, z. B. physische Entitäten für einen Verzeichnisdienst. Beispielsweise kann ein Auflistungsobjekt eine Liste von Druckaufträgen in einer Warteschlange oder eine Liste aktiver Sitzungen darstellen, die mit einem Server verbunden sind. Obwohl ein Auflistungsobjekt beliebige Datasets darstellen kann, müssen alle Elemente in einer Auflistung vom gleichen Typ sein. Die Daten sind vom Typ Variant .
ADSI macht auch die Schnittstellen IADsMembers und IADsContainer verfügbar, um zwei Sonderfälle von Sammlungsobjekten zu bearbeiten. IADsMembers wird für eine Auflistung von Objekten verwendet, die eine gemeinsame Mitgliedschaft gemeinsam nutzen. Ein Beispiel für solche Objekte sind Benutzer, die zu einer Gruppe gehören. IADsContainer gilt für ein ADSI-Objekt, das andere Objekte enthält. Ein Beispiel hierfür ist eine Verzeichnisstruktur oder eine Netzwerktopologie.
Vererbung
Die IADsCollection-Schnittstelle erbt von der IDispatch-Schnittstelle . IADsCollection verfügt auch über folgende Membertypen:
Methoden
Die IADsCollection-Schnittstelle verfügt über diese Methoden.
| IADsCollection::Add Fügt der Auflistung ein benanntes Element hinzu. |
| IADsCollection::get__NewEnum Die IADsCollection::get__NewEnum-Methode ruft ein abhängiges Enumeratorobjekt ab, das IEnumVARIANT für dieses ADSI-Auflistungsobjekt implementiert. Beachten Sie, dass der Funktionsname (get__NewEnum) zwei Unterstriche enthält. |
| IADsCollection::GetObject Ruft ein Element der Auflistung ab. |
| IADsCollection::Remove Die IADsCollection::Remove-Methode entfernt das benannte Element aus diesem ADSI-Auflistungsobjekt. |
Hinweise
Von den ADSI-Systemanbietern unterstützt nur der WinNT-Anbieter diese Schnittstelle, um aktive Dateidienstsitzungen, Ressourcen und Druckaufträge zu verarbeiten.
Anforderungen
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | iads.h |