Microsoft OLE DB Provider for Microsoft Active Directory Service

  • 發行項

Active Directory 服務介面 (ADSI) 提供者可讓 ADO 透過 ADSI 連線到異質目錄服務。 這可讓 ADO 應用程式以唯讀方式存取 Microsoft Windows NT 4.0 和 Microsoft Windows 2000 目錄服務，以及任何符合 LDAP 規範的目錄服務和 Novell Directory Services。 ADSI 本身是以提供者模型作為基礎，因此，如果有新的提供者提供另一個目錄的存取權，ADO 應用程式將能夠順暢地存取該目錄。 ADSI 提供者採用無限制執行緒且啟用 Unicode。

連接字串參數

若要連線至此提供者，請將 ConnectionString 屬性的 Provider 引數設定如下：

ADSDSOObject

讀取 Provider 屬性也會傳回此字串。

一般連接字串

此提供者的一般連接字串如下：

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

字串由下列關鍵字組成。

關鍵字 描述
提供者 指定 OLE DB Provider for Active Directory Service。
使用者識別碼 指定使用者名稱。 如果省略此關鍵字，則會使用目前的登入。
密碼 指定使用者密碼。 如果省略此關鍵字。 則會使用目前的登入。

注意

如果您要連線至支援 Windows 驗證的資料來源提供者，您應該指定 Trusted_Connection=yes 或 Integrated Security = SSPI，而非在連接字串中指定使用者識別碼和密碼資訊。

命令文字

提供者可辨識下列語法中有四個部分的命令文字字串：

"Root; Filter; Attributes[; Scope]"
值 描述
Root 指出要從中開始搜尋的 ADsPath 物件 (也就是搜尋的根目錄)。
Filter 指出 RFC 1960 格式的搜尋篩選。
屬性 指出要傳回的逗號分隔屬性清單。
範圍 選擇性。 會指定搜尋範圍的字串。 可以是下列其中一項：

- 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 唯讀
Bookmark 讀取/寫入
CacheSize 讀取/寫入
CursorLocation always adUseServer
CursorType always adOpenStatic
EditMode always adEditNone
EOF 唯讀
Filter 讀取/寫入
LockType 讀取/寫入
MarshalOptions 無法使用
MaxRecords 讀取/寫入
PageCount 唯讀
PageSize 讀取/寫入
RecordCount 唯讀
來源 讀取/寫入
State 唯讀
狀態 唯讀

標準 ADO Recordset 方法的可用性：

方法 是否可用？
AddNew No
取消 No
CancelBatch No
CancelUpdate No
複製 Yes
關閉 Yes
刪除 No
GetRows Yes
移動 Yes
MoveFirst Yes
MoveLast Yes
MoveNext Yes
MovePrevious Yes
NextRecordset Yes
開啟 Yes
Requery Yes
Resync Yes
支援 Yes
更新 No
UpdateBatch No

如需 ADSI 的詳細資訊和提供者的細節，請參閱 Active Directory 服務介面文件，或瀏覽 ADSI 網頁。

另請參閱

CommandType 屬性 (ADO)
ConnectionString 屬性 (ADO)
Properties 集合 (ADO)
Provider 屬性 (ADO)
Recordset 物件 (ADO)
Supports 方法