Поставщик Microsoft OLE DB для службы Microsoft Active Directory

Поставщик интерфейсов служб Active Directory (ADSI) позволяет ADO подключаться к разнородным службам каталогов через ADSI. Это предоставляет приложениям ADO доступ только для чтения к службам каталогов Microsoft Windows NT 4.0 и Microsoft Windows 2000 в дополнение к любой службе каталогов, совместимой с LDAP, и службам каталогов Novell. Сам ADSI основан на модели поставщика, поэтому при наличии нового поставщика, предоставляющего доступ к другому каталогу, приложение ADO сможет легко получить к нему доступ. Поставщик ADSI является бесплатным и включен Юникод.

Параметры строки соединения

Чтобы подключиться к этому поставщику, задайте для аргумента Provider свойства ConnectionString следующее:

ADSDSOObject  

Чтение свойства Provider также вернет эту строку.

Типичная строка подключения

Типичная строка подключения для этого поставщика выглядит следующим образом:

"Provider=ADSDSOObject;User ID=MyUserID;Password=MyPassword;"  

Строка состоит из следующих ключевых слов.

Ключевое слово	Описание
Поставщик	Указывает поставщик OLE DB для службы Active Directory.
Идентификатор пользователя	Указывает имя пользователя. Если этот ключевое слово опущен, используется текущий вход.
Пароль	Указывает пароль пользователя. Если этот ключевое слово опущен. Затем используется текущий вход.

Примечание

При подключении к поставщику источника данных, который поддерживает проверка подлинности Windows, в строке подключения следует указать Trusted_Connection=yes или Integrated Security = SSPI вместо идентификатора пользователя и пароля.

Текст команды

Текстовая строка из четырех частей команды распознается поставщиком в следующем синтаксисе:

"Root; Filter; Attributes[; Scope]"  

Значение	Описание
Корневой	Указывает объект ADsPath , с которого начинается поиск (т. е. корень поиска).
Фильтр	Указывает фильтр поиска в формате RFC 1960.
Атрибуты	Указывает разделенный запятыми список возвращаемых атрибутов.
Область	Необязательный элемент. Строка, указывающая область поиска. Может применяться один из перечисленных ниже типов. — Base — поиск только базового объекта (корня поиска). — OneLevel — поиск только на одном уровне. - Поддеревье — поиск по всему поддереву.

Пример:

"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"  

Поставщик также поддерживает SQL SELECT для текста команды. Пример:

"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE   
objectClass='user' AND objectCategory='Person'"  

Remarks

Поставщик не принимает вызовы хранимых процедур или простые имена таблиц (например, свойство CommandType всегда будет иметь значение adCmdText). Более подробное описание текстовых элементов команд см. в документации по интерфейсам служб Active Directory.

Поведение набора записей

В следующих таблицах перечислены функции, доступные в объекте Recordset, открытом с помощью этого поставщика. Доступен только тип статического курсора (adOpenStatic).

Для получения дополнительных сведений о поведении набора записей для конфигурации поставщика запустите метод Supports и перечислите коллекцию Propertiesнабора записей , чтобы определить, присутствуют ли динамические свойства конкретного поставщика.

Доступность стандартных свойств ADO Recordset:

Свойство	Доступность
AbsolutePage	чтение/запись
AbsolutePosition	чтение/запись
ActiveConnection	Только для чтения
BOF	Только для чтения
Закладка	чтение/запись
CacheSize	чтение/запись
CursorLocation	always adUseServer
CursorType	always adOpenStatic
EditMode	always adEditNone
EOF	Только для чтения
Фильтр	чтение/запись
LockType	чтение/запись
MarshalOptions	недоступно
MaxRecords	чтение/запись
Pagecount	Только для чтения
PageSize	чтение/запись
RecordCount	Только для чтения
Источник	чтение/запись
Состояние	Только для чтения
Состояние	Только для чтения

Доступность стандартных методов ADO Recordset:

Метод	Доступно?
Addnew	Нет
Отмена	Нет
CancelBatch	Нет
CancelUpdate	Нет
Clone	Да
Закрыть	Да
Удалить	Нет
GetRows	Да
Перемещение	Да
MoveFirst	Да
MoveLast	Да
MoveNext	Да
MovePrevious	Да
NextRecordset	Да
Открыть	Да
Requery	Да
Повторная синхронизация	Да
Поддерживает	Да
Обновление	Нет
UpdateBatch	Нет

Дополнительные сведения о ADSI и особенностях поставщика см. в документации по интерфейсам служб Active Directory или на веб-странице ADSI.

См. также:

Свойство CommandType (ADO)
Свойство ConnectionString (ADO)
Коллекция Properties (ADO)
Свойство Provider (ADO)
Объект Recordset (ADO)
Метод Supports