Microsoft OLE DB Provider for Microsoft Active Directory Service

Active Directory サービス インターフェイス (ADSI) プロバイダーを使用すると、ADO は ADSI を介して異種ディレクトリ サービスに接続できます。 これにより、ADO アプリケーションには、LDAP 準拠のディレクトリ サービスと Novell Directory Services に加えて、Microsoft Windows NT 4.0 および Microsoft Windows 2000 ディレクトリ サービスへの読み取り専用アクセスが提供されます。 ADSI 自体はプロバイダー モデルに基づいているため、別のディレクトリへのアクセス権を付与する新しいプロバイダーがある場合、ADO アプリケーションからシームレスにアクセスできます。 ADSI プロバイダーはフリースレッドであり、Unicode が有効になっています。

接続文字列パラメーター

このプロバイダーに接続するには、ConnectionString プロパティの Provider 引数を次のように設定します。

ADSDSOObject  

Provider プロパティを読み取った場合も、この文字列が返されます。

一般的な接続文字列

このプロバイダーの一般的な接続文字列は次のとおりです。

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

文字列は次のキーワードで構成されます。

キーワード	説明
プロバイダー	OLE DB Provider for Active Directory Service を指定します。
[ユーザー ID]	ユーザー名を指定します。 このキーワードを省略すると、現在のログオンが使用されます。
パスワード	ユーザー パスワードを指定します。 このキーワードを省略すると、 現在のログオンが使用されます。

注意

Windows 認証をサポートするデータ ソース プロバイダーに接続している場合、接続文字列にはユーザー ID とパスワード情報ではなく、Trusted_Connection=yes または Integrated Security = SSPI を指定してください。

コマンド テキスト

4 部構成のコマンド テキスト文字列は、次の構文でプロバイダーによって認識されます。

"Root; Filter; Attributes[; Scope]"  

値	説明
Root	検索を開始する ADsPath オブジェクト (つまり、検索のルート) を示します。
Assert	RFC 1960 形式の検索フィルターを示します。
属性	返される属性のコンマ区切りリストを示します。
スコープ	省略可能。 検索の範囲を指定する文字列。 以下のいずれかを指定できます。 - Base - ベース オブジェクト (検索のルート) のみを検索します。 - OneLevel - 1 つのレベルのみを検索します。 - 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	読み取り専用
Assert	読み取り/書き込み
LockType	読み取り/書き込み
MarshalOptions	利用不可
MaxRecords	読み取り/書き込み
PageCount	読み取り専用
PageSize	読み取り/書き込み
RecordCount	読み取り専用
ソース	読み取り/書き込み
State	読み取り専用
状態	読み取り専用

標準の ADO Recordset メソッドの使用可否:

メソッド	利用可能か
AddNew	いいえ
キャンセル	いいえ
CancelBatch	いいえ
CancelUpdate	いいえ
複製	はい
[閉じる]	はい
削除	No
GetRows	はい
移動	はい
MoveFirst	はい
MoveLast	はい
MoveNext	はい
MovePrevious	はい
NextRecordset	はい
[ファイル]	はい
Requery	はい
Resync	はい
サポート	はい
アップデート	No
UpdateBatch	いいえ

ADSI とプロバイダーの詳細については、Active Directory サービス インターフェイスのドキュメントを参照するか、ADSI Web ページをご覧ください。

参照

CommandType プロパティ (ADO)
ConnectionString プロパティ (ADO)
Properties コレクション (ADO)
Provider プロパティ (ADO)
Recordset オブジェクト (ADO)
Supports メソッド