Интерфейс IADsCollection (iads.h)

  • Статья

Интерфейс IADsCollection — это двойной интерфейс, который позволяет размещению объекта ADSI определять произвольный набор именованных элементов данных для службы каталогов и управлять им. Коллекции отличаются от массивов элементов тем, что отдельные элементы можно добавлять или удалять без изменения порядка всего массива.

Объекты коллекции могут представлять один или несколько элементов, соответствующих изменяющимся данным, таким как процессы или активные сеансы связи, а также постоянные данные, такие как физические сущности для службы каталогов. Например, объект коллекции может представлять список заданий печати в очереди или список активных сеансов, подключенных к серверу. Хотя объект коллекции может представлять произвольные наборы данных, все элементы в коллекции должны быть одного типа. Данные относятся к типам Variant .

ADSI также предоставляет интерфейсы IADsMembers и IADsContainer для управления двумя особыми случаями объектов коллекции. IADsMembers используется для коллекции объектов с общим членством. Примером таких объектов являются пользователи, принадлежащие группе. IADsContainer применяется к объекту ADSI, который содержит другие объекты. Примером этого является дерево каталогов или топология сети.

Наследование

Интерфейс IADsCollection наследуется от интерфейса IDispatch . IADsCollection также имеет следующие типы элементов:

Методы

Интерфейс IADsCollection содержит следующие методы.

 
IADsCollection::Add

Добавляет именованный элемент в коллекцию.
IADsCollection::get__NewEnum

Метод IADsCollection::get__NewEnum получает зависимый объект перечислителя, реализующий IEnumVARIANT для этого объекта коллекции ADSI. Имейте в виду, что в имени функции есть два символа подчеркивания (get__NewEnum).
IADsCollection::GetObject

Извлекает элемент коллекции.
IADsCollection::Remove

Метод IADsCollection::Remove удаляет именованный элемент из этого объекта коллекции ADSI.

Комментарии

Из поставщиков системы ADSI только поставщик WinNT поддерживает этот интерфейс для обработки активных сеансов файловой службы, ресурсов и заданий печати.

Требования

   
Минимальная версия клиента Windows Vista
Минимальная версия сервера Windows Server 2008
Целевая платформа Windows
Header iads.h

См. также раздел

IADsContainer

IADsMembers

IDispatch