Interface IADsCollection (iads.h)

  • Artigo

A interface IADsCollection é uma interface dupla que permite que seu objeto ADSI de hospedagem defina e gerencie um conjunto arbitrário de elementos de dados nomeados para um serviço de diretório. As coleções diferem de matrizes de elementos em que itens individuais podem ser adicionados ou excluídos sem reordenar toda a matriz.

Objetos de coleção podem representar um ou mais itens que correspondem a dados voláteis, como processos ou sessões de comunicação ativas, bem como dados persistentes, como entidades físicas para um serviço de diretório. Por exemplo, um objeto de coleção pode representar uma lista de trabalhos de impressão em uma fila ou uma lista de sessões ativas conectadas a um servidor. Embora um objeto de coleção possa representar conjuntos de dados arbitrários, todos os elementos em uma coleção devem ser do mesmo tipo. Os dados são de tipos Variant .

O ADSI também expõe as interfaces IADsMembers e IADsContainer para manipular dois casos especiais de objetos de coleção. IADsMembers é usado para uma coleção de objetos que compartilham uma associação comum. Um exemplo desses objetos são usuários que pertencem a um grupo. IADsContainer aplica-se a um objeto ADSI que contém outros objetos. Um exemplo disso é uma árvore de diretório ou uma topologia de rede.

Herança

A interface IADsCollection herda da interface IDispatch . IADsCollection também tem esses tipos de membros:

Métodos

A interface IADsCollection tem esses métodos.

 
IADsCollection::Add

Adiciona um item nomeado à coleção.
IADsCollection::get__NewEnum

O método IADsCollection::get__NewEnum obtém um objeto enumerador dependente que implementa IEnumVARIANT para este objeto de coleção ADSI. Lembre-se de que há dois caracteres de sublinhado no nome da função (get__NewEnum).
IADsCollection::GetObject

Recupera um item da coleção.
IADsCollection::Remove

O método IADsCollection::Remove remove o item nomeado deste objeto de coleção ADSI.

Comentários

Dos provedores de sistema ADSI, somente o provedor WinNT dá suporte a essa interface para lidar com sessões de serviço de arquivos ativas, recursos e trabalhos de impressão.

Requisitos

   
Cliente mínimo com suporte Windows Vista
Servidor mínimo com suporte Windows Server 2008
Plataforma de Destino Windows
Cabeçalho iads.h

Confira também

IADsContainer

IADsMembers

IDispatch