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=<password>;"
字串由下列關鍵字組成。
關鍵字 | 描述 |
---|---|
提供者 | 指定 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 方法