Menyambungkan dengan SQLBrowseConnect

  • Artikel

SQLBrowse Koneksi, seperti SQLDriver Koneksi, menggunakan string koneksi. Namun, dengan menggunakan SQLBrowse Koneksi, aplikasi dapat membangun 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 SQLBrowse Koneksi dan meneruskan string koneksi, yang dikenal sebagai permintaan penelusuran string koneksi, yang menentukan driver atau sumber data. Driver mengembalikan string koneksi, yang dikenal sebagai hasil penelusuran string koneksi, 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 permintaan penelusuran baru string koneksi dari nilai-nilai ini dan mengembalikannya ke driver dengan panggilan lain ke SQLBrowse Koneksi.

Karena string koneksi diteruskan bolak-balik, driver dapat menyediakan beberapa tingkat penjelajahan dengan mengembalikan string koneksi baru ketika aplikasi mengembalikan yang lama. Misalnya, pertama kali aplikasi memanggil SQLBrowse Koneksi, 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 SQLBrowse Koneksi mengembalikan hasil penelusuran baru string koneksi, SQLBrowse mengembalikan SQL_NEED_DATA sebagai kode pengembaliannya. Ini memberi tahu aplikasi bahwa proses koneksi tidak selesai. Hingga SQLBrowse Koneksi mengembalikan SQL_SUCCESS, koneksi berada dalam status Perlu 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.