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 メソッド