Colecciones y grupos

ADSI usa objetos de colección para representar cualquier conjunto arbitrario de elementos de un servicio de directorio que se pueda representar mediante el mismo tipo de datos. Los objetos de colección se definen como un conjunto de valores variant, que representan cualquiera de los tipos de datos de Automation válidos. Los objetos de colección pueden representar información persistente, como listas de control de acceso e información volátil, como trabajos de impresión en una cola de impresión.

La convención COM estándar para enumerar el contenido de un objeto de colección (o contenedor) es crear un objeto enumerador que admita IEnumVARIANT, que tiene métodos para recorrer la lista de objetos de colección. Las interfaces de ADSI que proporcionan el método get__NewEnum (tenga en cuenta los dos caracteres de subrayado) son IADsContainer, IADsMembers y IADsCollection. ADSI también proporciona las funciones auxiliares ADsBuildEnumerator y ADsEnumerateNext para programas de C y C++ para simplificar la enumeración. Los clientes de Automation usan la enumeración implícitamente cuando llaman a Siguiente en un bucle for de.

Los grupos son simplemente colecciones de objetos que admiten la interfazIADsMembers.