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 con 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 válidos de Automation. 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 (observe los dos caracteres de subrayado) son IADsContainer, IADsMembers e IADsCollection. ADSI también proporciona las funciones auxiliares ADsBuildEnumerator y ADsEnumerateNext para los programas de C y C++ para simplificar la enumeración. Los clientes de Automation usan la enumeración implícitamente cuando llaman a Next en un bucle For .

Los grupos son simplemente colecciones de objetos que admiten la interfaz IADsMembers .