Поставщик 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 использует свободную многопоточность и поддерживает Юникод.
Параметры строки подключения
Чтобы подключиться к этому поставщику, задайте аргумент поставщика свойства ConnectionStr ing следующим образом:
ADSDSOObject
Чтение свойства поставщика также вернёт эту строку.
Типичная строка подключения
Типичная строка подключения для этого поставщика выглядит следующим образом:
"Provider=ADSDSOObject;User ID=MyUserID;Password=<password>;"
Строка состоит из следующих ключевых слов.
| Ключевое слово | Описание |
|---|---|
| поставщик | Указывает поставщик OLE DB для службы Active Directory. |
| идентификатор пользователя | Указывает имя пользователя. Если это ключевое слово не указано, используется текущий вход. |
| пароль | Указывает пароль пользователя. Если это ключевое слово опущено. Затем будет использован текущий логон. |
Заметка
Если вы подключаетесь к поставщику источника данных, поддерживающему Проверку подлинности Windows, следует указать Trusted_Connection=да или Интегрированная безопасность=SSPI вместо User ID и пароля в строке подключения.
Текст команды
Четырехкомпонентная текстовая строка команды распознается поставщиком в следующем синтаксисе:
"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'"
Замечания
Поставщик не принимает вызовы хранимых процедур или простые имена таблиц (например, свойство CommandType всегда будет adCmdText). Дополнительные сведения о текстовых элементах команды см. в документации по интерфейсам службы Active Directory.
Поведение набора записей
В следующих таблицах перечислены возможности, доступные в объекте Recordset Recordset, открытом через данного поставщика. Доступен только статический тип курсора (adOpenStatic).
Для получения дополнительной информации о поведении набора записей для конфигурации поставщика, выполните метод Поддерживает и переберите коллекцию свойств набора записей , чтобы определить, присутствуют ли динамические свойства, специфичные для поставщика.
Доступность стандартных свойств набора записей ADO:
| Свойство | Наличие |
|---|---|
| AbsolutePage | чтение и запись |
| AbsolutePosition | чтение и запись |
| АктивноеСоединение | Только для чтения |
| BOF | Только для чтения |
| закладка | чтение и запись |
| CacheSize | чтение и запись |
| МестоположениеКурсора | всегда adUseServer |
| CursorType | всегда adOpenStatic |
| Режим редактирования | всегда adEditNone |
| EOF | Только для чтения |
| фильтр | чтение и запись |
| Тип замка | чтение и запись |
| MarshalOptions | недоступно |
| MaxRecords | чтение и запись |
| PageCount | Только для чтения |
| РазмерСтраницы | чтение и запись |
| RecordCount | Только для чтения |
| источник | чтение и запись |
| состояние | Только для чтения |
| статус | Только для чтения |
Доступность стандартных методов ADO Recordset:
| Метод | Доступный? |
|---|---|
| ДобавитьНовое | Нет |
| Отмена | Нет |
| Отменить пакет | Нет |
| Отменить обновление | Нет |
| Клон | Да |
| закрыть | Да |
| Удалить | Нет |
| GetRows | Да |
| перемещение | Да |
| MoveFirst | Да |
| MoveLast | Да |
| MoveNext | Да |
| Предыдущий | Да |
| СледующийНаборЗаписей | Да |
| Открыть | Да |
| Повторный запрос | Да |
| повторная синхронизация | Да |
| поддерживает | Да |
| обновление | Нет |
| UpdateBatch | Нет |
Дополнительные сведения о ADSI и особенности поставщика см. в документации по интерфейсам служб Active Directory или на веб-странице ADSI.
См. также
свойство CommandType (ADO)
Свойство ConnectionString (ADO)
Коллекция свойств (ADO)
Свойство поставщика (ADO)
объекта набора записей
поддерживает метод