Поставщик 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