Menyambungkan dengan SQLBrowseConnect

SQLBrowseConnect, seperti SQLDriverConnect, menggunakan string koneksi. Namun, dengan menggunakan SQLBrowseConnect, aplikasi dapat membuat string koneksi lengkap pada waktu proses. Ini memungkinkan aplikasi untuk melakukan dua hal:

• Buat kotak dialognya sendiri untuk meminta informasi ini, sehingga mempertahankan kontrol atas "tampilan dan nuansanya."

• Telusuri sistem untuk sumber data yang dapat digunakan oleh driver tertentu, mungkin dalam beberapa langkah. Misalnya, pengguna mungkin terlebih dahulu menelusuri jaringan untuk server dan, setelah memilih server, telusuri server untuk database yang dapat diakses oleh driver.

Aplikasi memanggil SQLBrowseConnect dan meneruskan string koneksi, yang dikenal sebagai string koneksi permintaan penelusuran, yang menentukan driver atau sumber data. Driver mengembalikan string koneksi, yang dikenal sebagai string koneksi hasil penelusuran, yang berisi kata kunci, nilai yang mungkin (jika kata kunci menerima sekumpulan nilai diskrit), dan nama yang mudah digunakan. Aplikasi membangun kotak dialog dengan nama yang mudah digunakan dan meminta nilai kepada pengguna. Kemudian membangun string koneksi permintaan penelusuran baru dari nilai-nilai ini dan mengembalikannya ke driver dengan panggilan lain ke SQLBrowseConnect.

Karena string koneksi diteruskan bolak-balik, driver dapat menyediakan beberapa tingkat penjelajahan dengan mengembalikan string koneksi baru saat aplikasi mengembalikan yang lama. Misalnya, pertama kali aplikasi memanggil SQLBrowseConnect, driver mungkin mengembalikan kata kunci untuk meminta nama server kepada pengguna. Ketika aplikasi mengembalikan nama server, driver mungkin mengembalikan kata kunci untuk meminta pengguna untuk database. Proses penjelajahan akan selesai setelah aplikasi mengembalikan nama database.

Setiap kali SQLBrowseConnect mengembalikan string koneksi hasil penelusuran baru, SQLBrowseConnect mengembalikan SQL_NEED_DATA sebagai kode pengembaliannya. Ini memberi tahu aplikasi bahwa proses koneksi tidak selesai. Hingga SQLBrowseConnect mengembalikan SQL_SUCCESS, koneksi berada dalam status Memerlukan Data dan tidak dapat digunakan untuk tujuan lain, seperti untuk mengatur atribut koneksi. Aplikasi dapat mengakhiri proses penjelajahan koneksi dengan memanggil SQLDisconnect.

Bagian ini berisi topik berikut.

• Contoh Penelusuran SQL Server