用于 Microsoft Active Directory 服务的 Microsoft OLE DB 提供程序
Active Directory 服务接口 (ADSI) 提供程序允许 ADO 通过 ADSI 连接到异类目录服务。 这样,除了任何符合 LDAP 的目录服务和 Novell 目录服务之外,ADO 应用程序还可以以只读方式访问 Microsoft Windows NT 4.0 和 Microsoft Windows 2000 目录服务。 ADSI 本身基于提供程序模型,因此,如果有一个新的提供程序授予对另一个目录的访问权限,ADO 应用程序将能够无缝访问它。 ADSI 提供程序已启用自由线程和 Unicode。
连接字符串参数
若要连接到此提供程序,请将 ConnectionString 属性的 Provider 参数设置为以下内容:
ADSDSOObject
读取 Provider 属性也会返回此字符串。
典型连接字符串
此提供程序的典型连接字符串如下所示:
"Provider=ADSDSOObject;User ID=MyUserID;Password=MyPassword;"
字符串由以下关键字组成。
关键字 | 说明 |
---|---|
提供程序 | 指定用于 Active Directory 服务的 OLE DB 提供程序。 |
用户 ID | 指定用户名。 如果省略此关键字,则使用当前登录。 |
密码 | 指定用户密码。 如果省略此关键字, 则使用当前登录。 |
注意
如果要连接到支持 Windows 身份验证的数据源提供程序,则应指定 Trusted_Connection=yes 或 Integrated Security = SSPI,而不是连接字符串中的用户 ID 和密码信息。
命令文本
提供程序按照以下语法识别由四部分组成的命令文本字符串:
"Root; Filter; Attributes[; Scope]"
值 | 说明 |
---|---|
Root | 指示从中启动搜索的 ADsPath 对象(即搜索的根)。 |
Filter | 指示 RFC 1960 格式的搜索筛选器。 |
特性 | 指示要返回的以逗号分隔的属性列表。 |
范围 | 可选。 指定搜索范围的 String。 可以是以下值之一: - Base - 仅搜索基对象(搜索的根)。 - OneLevel - 仅搜索一个级别。 - Subtree - 搜索整个子树。 |
例如:
"<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) 可用。
有关提供程序配置的 Recordset 行为的更多详细信息,请运行 Supports 方法并枚举 Recordset 的 Properties 集合以确定是否存在特定于提供程序的动态属性。
标准 ADO Recordset 属性的可用性:
属性 | 可用性 |
---|---|
AbsolutePage | 读/写 |
AbsolutePosition | 读/写 |
ActiveConnection | 只读 |
BOF | 只读 |
书签 | 读/写 |
CacheSize | 读/写 |
CursorLocation | 始终为 adUseServer |
CursorType | 始终为 adOpenStatic |
EditMode | 始终为 adEditNone |
EOF | 只读 |
Filter | 读/写 |
LockType | 读/写 |
MarshalOptions | 不可用 |
MaxRecords | 读/写 |
PageCount | 只读 |
PageSize | 读/写 |
RecordCount | 只读 |
Source | 读/写 |
State | 只读 |
状态 | 只读 |
标准 ADO Recordset 方法的可用性:
方法 | 是否可用? |
---|---|
AddNew | 否 |
取消 | 否 |
CancelBatch | 否 |
CancelUpdate | 否 |
克隆 | 是 |
关闭 | 是 |
删除 | 否 |
GetRows | 是 |
移动 | 是 |
MoveFirst | 是 |
MoveFirst | 是 |
MoveNext | 是 |
MovePrevious | 是 |
NextRecordset | 是 |
打开 | 是 |
Requery | 是 |
Resync | 是 |
支持 | 是 |
更新 | 否 |
UpdateBatch | 否 |
有关 ADSI 和提供程序细节的详细信息,请参阅“Active Directory 服务接口”文档或访问 ADSI 网页。
另请参阅
CommandType 属性 (ADO)
ConnectionString 属性 (ADO)
属性集合 (ADO)
Provider 属性 (ADO)
记录集对象 (ADO)
Supports 方法