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=<password>;"
字串包含下列關鍵詞。
| 關鍵詞 | 描述 |
|---|---|
| 提供者 | 指定 Active Directory 服務的 OLE DB 提供者。 |
| 用戶標識碼 | 指定用戶名稱。 如果省略此關鍵詞,則會使用目前的登入。 |
| 密碼 | 指定用戶密碼。 如果省略這個關鍵詞。 然後將使用目前的登入。 |
注意
如果您要連線到支援 Windows 驗證的數據源提供者,您應該指定 Trusted_Connection=yes 或 Integrated Security = SSPI,而不是連接字元串中的使用者識別符和密碼資訊。
命令文字
提供者會以下列語法辨識四部分命令文字字串:
"Root; Filter; Attributes[; Scope]"
| 價值 | 描述 |
|---|---|
| 根 | 指出從中開始搜尋的 ADsPath 物件(也就是搜尋的根目錄)。 |
| 篩選 | 指出 RFC 1960 格式的搜尋篩選。 |
| 屬性 | 表示要傳回的屬性逗號分隔清單。 |
| 範圍 | 自選。 指定搜尋範圍的字串 。 可以是下列其中一項: - 基底 - 只搜尋基底物件(搜尋的根目錄)。 - 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)是可用的。
如需瞭解有關提供者設定的 Recordset 行為的詳細資訊,請執行 Supports 方法,並列舉 Properties 集合,以判斷 Recordset 中是否存在提供者特定的動態屬性。
標準 ADO 記錄集屬性的可用性:
| 財產 | 可用性 |
|---|---|
| AbsolutePage | 讀取/寫入 |
| 絕對位置 | 讀取/寫入 |
| ActiveConnection | 唯讀 |
| BOF | 唯讀 |
| 書籤 | 讀取/寫入 |
| CacheSize | 讀取/寫入 |
| 游標位置 | 一律 adUseServer |
| 游標類型 | 一律 adOpenStatic |
| 編輯模式 | 總是 無編輯廣告 |
| EOF | 唯讀 |
| 篩選 | 讀取/寫入 |
| 鎖定類型 | 讀取/寫入 |
| MarshalOptions | 不可用 |
| MaxRecords | 讀取/寫入 |
| 頁數 | 唯讀 |
| 頁面大小 | 讀取/寫入 |
| RecordCount | 唯讀 |
| 來源 | 讀取/寫入 |
| 狀態 | 唯讀 |
| 狀態 | 唯讀 |
標準 ADO Recordset 方法的可用性:
| 方法 | 可用? |
|---|---|
| 新增 | 不 |
| 取消 | 不 |
| 取消批次 | 不 |
| 取消更新 | 不 |
| 複製 | 是的 |
| 關閉 | 是的 |
| 刪除 | 不 |
| 取得資料列 | 是的 |
| 移動 | 是的 |
| 首先移動 | 是的 |
| 移至最後 | 是的 |
| MoveNext | 是的 |
| 上一個 | 是的 |
| NextRecordset | 是的 |
| 開啟 | 是的 |
| 重新查詢 | 是的 |
| 同步重啟 | 是的 |
| 支援 | 是的 |
| 更新 | 不 |
| UpdateBatch | 不 |
如需 ADSI 和提供者細節的詳細資訊,請參閱 Active Directory 服務介面檔,或流覽 ADSI 網頁。
另請參閱
CommandType 屬性 (ADO)
ConnectionString 屬性 (ADO)
Properties 屬性集合(ADO)
Provider 屬性 (ADO)
Recordset 物件 (ADO)
支援方法