Interface IADsCollection (iads.h)

L’interface IADsCollection est une interface double qui permet à son objet ADSI d’hébergement de définir et de gérer un ensemble arbitraire d’éléments de données nommés pour un service d’annuaire. Les collections diffèrent des tableaux d’éléments en ce que des éléments individuels peuvent être ajoutés ou supprimés sans réorganiser l’ensemble du tableau.

Les objets de collection peuvent représenter un ou plusieurs éléments qui correspondent à des données volatiles, telles que des processus ou des sessions de communication actives, ainsi que des données persistantes, telles que des entités physiques pour un service d’annuaire. Par exemple, un objet de collection peut représenter une liste de travaux d’impression dans une file d’attente ou une liste de sessions actives connectées à un serveur. Bien qu’un objet de collection puisse représenter des jeux de données arbitraires, tous les éléments d’une collection doivent être du même type. Les données sont de types Variant .

ADSI expose également les interfaces IADsMembers et IADsContainer pour la manipulation de deux cas spéciaux d’objets de collection. IADsMembers est utilisé pour une collection d’objets qui partagent une appartenance commune. Les utilisateurs qui appartiennent à un groupe sont un exemple de tels objets. IADsContainer s’applique à un objet ADSI qui contient d’autres objets. Une arborescence de répertoires ou une topologie réseau en est un exemple.

Héritage

L’interface IADsCollection hérite de l’interface IDispatch. IADsCollection a également les types de membres suivants :

Méthodes

L’interface IADsCollection comporte ces méthodes.

IADsCollection::Add Ajoute un élément nommé à la collection.
IADsCollection::get__NewEnum La méthode IADsCollection::get__NewEnum obtient un objet énumérateur dépendant qui implémente IEnumVARIANT pour cet objet de collection ADSI. N’oubliez pas qu’il existe deux caractères de soulignement dans le nom de la fonction (get__NewEnum).
IADsCollection::GetObject Récupère un élément de la collection.
IADsCollection::Remove La méthode IADsCollection::Remove supprime l’élément nommé de cet objet de collection ADSI.

Notes

Parmi les fournisseurs de système ADSI, seul le fournisseur WinNT prend en charge cette interface pour gérer les sessions de service de fichiers actifs, les ressources et les travaux d’impression.

Configuration requise

Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	iads.h

Voir aussi

IADsContainer

IADsMembers

IDispatch