Interfaz IADsCollection (iads.h)
La interfaz IADsCollection es una interfaz dual que permite que su objeto ADSI de hospedaje defina y administre un conjunto arbitrario de elementos de datos con nombre para un servicio de directorio. Las colecciones difieren de las matrices de elementos de que se pueden agregar o eliminar elementos individuales sin reordenar toda la matriz.
Los objetos de colección pueden representar uno o varios elementos que corresponden a datos volátiles, como procesos o sesiones de comunicación activas, así como datos persistentes, como entidades físicas para un servicio de directorio. Por ejemplo, un objeto de colección puede representar una lista de trabajos de impresión en una cola o una lista de sesiones activas conectadas a un servidor. Aunque un objeto de colección puede representar conjuntos de datos arbitrarios, todos los elementos de una colección deben ser del mismo tipo. Los datos son de tipos Variant .
ADSI también expone las interfaces IADsMembers e IADsContainer para manipular dos casos especiales de objetos de colección. IADsMembers se usa para una colección de objetos que comparten una pertenencia común. Un ejemplo de estos objetos son usuarios que pertenecen a un grupo. IADsContainer se aplica a un objeto ADSI que contiene otros objetos. Un ejemplo de esto es un árbol de directorios o una topología de red.
Herencia
La interfaz IADsCollection hereda de la interfaz IDispatch . IADsCollection también tiene estos tipos de miembros:
Métodos
La interfaz IADsCollection tiene estos métodos.
| IADsCollection::Add Agrega un elemento con nombre a la colección. |
| IADsCollection::get__NewEnum El método IADsCollection::get__NewEnum obtiene un objeto enumerador dependiente que implementa IEnumVARIANT para este objeto de colección ADSI. Tenga en cuenta que hay dos caracteres de subrayado en el nombre de la función (get__NewEnum). |
| IADsCollection::GetObject Recupera un elemento de la colección. |
| IADsCollection::Remove El método IADsCollection::Remove quita el elemento con nombre de este objeto de colección ADSI. |
Comentarios
De los proveedores del sistema ADSI, solo el proveedor winNT admite esta interfaz para controlar las sesiones activas del servicio de archivos, los recursos y los trabajos de impresión.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | iads.h |