Penyedia Microsoft OLE DB untuk Layanan Microsoft Active Directory

Penyedia Antarmuka Layanan Direktori Aktif (ADSI) memungkinkan ADO terhubung ke layanan direktori heterogen melalui ADSI. Ini memberi aplikasi ADO akses baca-saja ke layanan direktori Microsoft Windows NT 4.0 dan Microsoft Windows 2000, selain layanan direktori yang mematuhi LDAP dan Layanan Direktori Novell. ADSI sendiri didasarkan pada model penyedia, sehingga jika ada penyedia baru yang memberikan akses ke direktori lain, aplikasi ADO akan dapat mengaksesnya dengan mulus. Penyedia ADSI berutas bebas dan Unicode diaktifkan.

Parameter String Koneksi

Untuk menyambungkan ke penyedia ini, atur argumen Penyedia properti ConnectionString ke berikut ini:

ADSDSOObject  

Membaca properti Penyedia juga akan mengembalikan string ini.

String Koneksi Umum

String koneksi umum untuk penyedia ini adalah sebagai berikut:

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

String terdiri dari kata kunci berikut.

Kata kunci	Deskripsi
Penyedia	Menentukan Penyedia OLE DB untuk Layanan Direktori Aktif.
ID Pengguna	Menentukan nama pengguna. Jika kata kunci ini dihilangkan, log masuk saat ini akan digunakan.
Kata sandi	Menentukan kata sandi pengguna. Jika kata kunci ini dihilangkan. Kemudian log masuk saat ini digunakan.

Catatan

Jika Anda menyambungkan ke penyedia sumber data yang mendukung autentikasi Windows, Anda harus menentukan Trusted_Connection=yes atau Integrated Security = SSPI alih-alih ID pengguna dan informasi kata sandi dalam string koneksi.

Teks Perintah

String teks perintah empat bagian dikenali oleh penyedia dalam sintaks berikut:

"Root; Filter; Attributes[; Scope]"  

Nilai	Deskripsi
Akar	Menunjukkan objek ADsPath tempat memulai pencarian (yaitu, akar pencarian).
Filter	Menunjukkan filter pencarian dalam format RFC 1960.
Atribut	Menunjukkan daftar atribut yang dibatasi koma yang akan dikembalikan.
Cakupan	Opsional. String yang menentukan cakupan pencarian. Bisa jadi salah satu dari yang berikut: - Dasar - Cari hanya objek dasar (akar pencarian). - OneLevel - Cari hanya satu tingkat. - Subtree - Cari seluruh subtree.

Contohnya:

"<LDAP://DC=ArcadiaBay,DC=COM>;(objectClass=*);sn, givenName; subtree"  

Penyedia juga mendukung SQL SELECT untuk teks perintah. Contohnya:

"SELECT title, telephoneNumber From 'LDAP://DC=Microsoft, DC=COM' WHERE   
objectClass='user' AND objectCategory='Person'"  

Keterangan

Penyedia tidak menerima panggilan prosedur tersimpan atau nama tabel sederhana (misalnya, properti CommandType akan selalu adCmdText). Lihat dokumentasi Antarmuka Layanan Direktori Aktif untuk deskripsi elemen teks perintah yang lebih menyeluruh.

Perilaku Recordset

Tabel berikut ini mencantumkan fitur yang tersedia pada objek Recordset yang dibuka dengan menggunakan penyedia ini. Hanya jenis kursor statis (adOpenStatic) yang tersedia.

Untuk informasi selengkapnya tentang perilaku Recordset untuk konfigurasi penyedia Anda, jalankan metode Dukungan dan hitung kumpulan PropertiRecordset untuk menentukan apakah properti dinamis khusus penyedia ada.

Ketersediaan properti ADO Recordset standar:

Properti	Ketersediaan
AbsolutePage	baca/tulis
AbsolutePosition	baca/tulis
ActiveConnection	baca-saja
BOF	baca-saja
Bookmark	baca/tulis
CacheSize	baca/tulis
CursorLocation	selalu adUseServer
Cursortype	selalu adOpenStatic
EditMode	selalu adEditNone
EOF	baca-saja
Filter	baca/tulis
LockType	baca/tulis
MarshalOptions	tidak tersedia
MaxRecords	baca/tulis
PageCount	baca-saja
PageSize	baca/tulis
RecordCount	baca-saja
Sumber	baca/tulis
Provinsi	baca-saja
Status	baca-saja

Ketersediaan metode ADO Recordset standar:

Metode	Tersedia?
TambahkanBaru	Tidak
Batalkan	Tidak
CancelBatch	Tidak
CancelUpdate	Tidak
Kloning	Ya
Tutup	Ya
Hapus	Tidak
GetRows	Ya
Bergerak	Ya
MoveFirst	Ya
MoveLast	Ya
MoveNext	Ya
MovePrevious	Ya
NextRecordset	Ya
Buka	Ya
Kueri Ulang	Ya
Sinkronkan ulang	Ya
Mendukung	Ya
Pembaruan	Tidak
UpdateBatch	Tidak

Untuk informasi selengkapnya tentang ADSI dan spesifikasi penyedia, lihat dokumentasi Antarmuka Layanan Direktori Aktif atau kunjungi halaman Web ADSI.

Lihat juga

Properti CommandType (ADO)
Properti ConnectionString (ADO)
Kumpulan Properti (ADO)
Properti Penyedia (ADO)
Objek Recordset (ADO)
Metode Mendukung