Fungsi SQLDriverConnect

Kesesuaian
Versi Diperkenalkan: Kepatuhan Standar ODBC 1.0: ODBC

Ringkasan
SQLDriverConnect adalah alternatif untuk SQLConnect. Ini mendukung sumber data yang memerlukan lebih banyak informasi koneksi daripada tiga argumen di SQLConnect, kotak dialog untuk meminta pengguna untuk semua informasi koneksi, dan sumber data yang tidak ditentukan dalam informasi sistem. Untuk informasi selengkapnya, lihat Menghubungkan dengan SQLDriverConnect.

Syntax

  
SQLRETURN SQLDriverConnect(  
     SQLHDBC         ConnectionHandle,  
     SQLHWND         WindowHandle,  
     SQLCHAR *       InConnectionString,  
     SQLSMALLINT     StringLength1,  
     SQLCHAR *       OutConnectionString,  
     SQLSMALLINT     BufferLength,  
     SQLSMALLINT *   StringLength2Ptr,  
     SQLUSMALLINT    DriverCompletion);  

Arguments

ConnectionHandle
[Input] Handel koneksi.

Pegangan Jendela
[Masukan] Pegangan jendela. Aplikasi dapat meneruskan pegangan jendela induk, jika ada, atau penunjuk null jika salah satu pegangan jendela tidak berlaku atau SQLDriverConnect tidak akan menyajikan kotak dialog apa pun.

InConnectionString
[Masukan] string koneksi lengkap (lihat sintaks di "Komentar"), string koneksi parsial, atau string kosong.

PanjangString1
[Masukan] Panjang *InConnectionString, dalam karakter jika stringnya Unicode, atau byte jika string ANSI atau DBCS.

OutConnectionString
[Keluaran] Penunjuk ke buffer untuk string koneksi yang telah selesai. Setelah koneksi berhasil ke sumber data target, buffer ini berisi string koneksi yang telah selesai. Aplikasi harus mengalokasikan setidaknya 1.024 karakter untuk buffer ini.

Jika OutConnectionString adalah NULL, StringLength2Ptr masih akan mengembalikan jumlah total karakter (tidak termasuk karakter penghentian null untuk data karakter) yang tersedia untuk dikembalikan dalam buffer yang ditunjuk oleh OutConnectionString.

BufferLength
[Masukan] Panjang buffer *OutConnectionString , dalam karakter.

Panjang String2Ptr
[Keluaran] Penunjuk ke buffer untuk mengembalikan jumlah total karakter (tidak termasuk karakter penghentian null) yang tersedia untuk dikembalikan di *OutConnectionString. Jika jumlah karakter yang tersedia untuk dikembalikan lebih besar dari atau sama dengan BufferLength, string koneksi yang telah diselesaikan di *OutConnectionString dipotong ke BufferLength dikurangi panjang karakter penghentian null.

Penyelesaian Pengemudi
[Masukan] Bendera yang menunjukkan apakah Pengelola Driver atau driver harus meminta informasi koneksi selengkapnya:

SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, SQL_DRIVER_COMPLETE_REQUIRED, atau SQL_DRIVER_NOPROMPT.

(Untuk informasi tambahan, lihat "Komentar.")

Returns

SQL_SUCCESS, SQL_SUCCESS_WITH_INFO, SQL_NO_DATA, SQL_ERROR, SQL_INVALID_HANDLE, atau SQL_STILL_EXECUTING.

Diagnostics

Ketika SQLDriverConnect mengembalikan SQL_ERROR atau SQL_SUCCESS_WITH_INFO, nilai SQLSTATE terkait dapat diperoleh dengan memanggil SQLGetDiagRec dengan fHandleType SQL_HANDLE_DBC dan hHandle dari ConnectionHandle. Tabel berikut mencantumkan nilai SQLSTATE yang biasa dikembalikan oleh SQLDriverConnect dan menjelaskan masing-masing nilai dalam konteks fungsi ini; notasi "(DM)" mendahului deskripsi SQLSTATE yang dikembalikan oleh Driver Manager. Kode pengembalian yang terkait dengan setiap nilai SQLSTATE SQL_ERROR, kecuali disebutkan sebaliknya.

Komentar

string koneksi memiliki sintaks berikut:

connection-string ::= empty-string[;] | atribut[;] | atribut; koneksi-string

empty-string ::=atribut ::= atribut-kata kunci=atribut-nilai | DRIVER=[{]atribut-nilai[}]

atribut-kata kunci ::= DSN | UID | PENYANDANG disabilitas | driver-defined-attribute-keyword

atribut-nilai ::= karakter-string

driver-defined-attribute-keyword ::= identifier

di mana string karakter memiliki nol atau lebih karakter; pengidentifikasi memiliki satu atau beberapa karakter; attribute-keyword tidak peka huruf besar/kecil; nilai atribut mungkin peka huruf besar/kecil; dan nilai kata kunci DSN tidak hanya terdiri dari kosong.

Karena tata bahasa string koneksi dan file inisialisasi, kata kunci, dan atribut yang berisi karakter []{}(),;? *=!@ Tidak disertakan dengan kurung kurawal harus dihindari. Nilai kata kunci DSN tidak boleh hanya terdiri dari kosong dan tidak boleh berisi kosong di depan. Karena tata bahasa informasi sistem, kata kunci dan nama sumber data tidak boleh berisi karakter garis miring terbelakang (\).

Aplikasi tidak perlu menambahkan kurung kurawal di sekitar nilai atribut setelah kata kunci DRIVER kecuali atribut berisi titik koma (;), dalam hal ini kurung kurawal diperlukan. Jika nilai atribut yang diterima driver menyertakan kurung kurawal, driver tidak boleh menghapusnya tetapi harus menjadi bagian dari string koneksi yang dikembalikan.

Nilai DSN atau string koneksi yang diapit dengan kurung kurawal ({}) yang berisi salah satu karakter []{}(),;? *=!@ diteruskan utuh ke pengemudi. Namun, saat menggunakan karakter ini dalam kata kunci, Driver Manager mengembalikan kesalahan saat bekerja dengan file DSN tetapi meneruskan string koneksi ke driver untuk string koneksi biasa. Hindari menggunakan kurung kurawal yang disematkan dalam nilai kata kunci.

String koneksi dapat mencakup sejumlah kata kunci yang ditentukan driver. Karena kata kunci DRIVER tidak menggunakan informasi dari informasi sistem, driver harus menentukan kata kunci yang cukup sehingga driver dapat terhubung ke sumber data hanya menggunakan informasi dalam string koneksi. (Untuk informasi selengkapnya, lihat "Pedoman Pengemudi", nanti di bagian ini.) Driver menentukan kata kunci mana yang diperlukan untuk terhubung ke sumber data.

Tabel berikut menjelaskan nilai atribut kata kunci DSN, FILEDSN, DRIVER,UID, PWD, dan SAVEFILE .

Untuk informasi tentang cara aplikasi memilih sumber data atau driver, lihat Memilih Sumber Data atau Driver.

Jika ada kata kunci yang diulang dalam string koneksi, driver menggunakan nilai yang terkait dengan kemunculan pertama kata kunci. Jika kata kunci DSN dan DRIVER disertakan dalam string koneksi yang sama, Driver Manager dan driver menggunakan kata kunci mana pun yang muncul lebih dulu.

Kata kunci FILEDSN dan DSN saling eksklusif: kata kunci mana pun yang muncul pertama kali digunakan, dan kata kunci yang muncul kedua diabaikan. Kata kunci FILEDSN dan DRIVER , di sisi lain, tidak saling eksklusif. Jika kata kunci apa pun muncul dalam string koneksi dengan FILEDSN, maka nilai atribut kata kunci dalam string koneksi digunakan daripada nilai atribut kata kunci yang sama dalam file .dsn.

Jika kata kunci FILEDSN digunakan, kata kunci yang ditentukan dalam file .dsn digunakan untuk membuat string koneksi. (Untuk informasi selengkapnya, lihat "Sumber Data File", nanti di bagian ini.) Kata kunci UID bersifat opsional; file .dsn dapat dibuat hanya dengan kata kunci DRIVER . Kata kunci PWD tidak disimpan dalam file .dsn. Direktori default untuk menyimpan dan memuat file .dsn akan menjadi kombinasi dari jalur yang ditentukan oleh CommonFileDir di HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\ Windows\CurrentVersion dan "ODBC\DataSources". (Jika CommonFileDir adalah "C:\Program Files\Common Files", direktori defaultnya adalah "C:\Program Files\Common Files\ODBC\Data Sources".)

Jika kata kunci SAVEFILE digunakan, nilai atribut kata kunci yang digunakan dalam membuat koneksi yang berhasil akan disimpan sebagai file .dsn dengan nama nilai atribut kata kunci SAVEFILE . Kata kunci SAVEFILE harus digunakan bersama dengan kata kunci DRIVER , kata kunci FILEDSN , atau keduanya, atau fungsi mengembalikan SQL_SUCCESS_WITH_INFO dengan SQLSTATE 01S09 (Kata kunci tidak valid). Kata kunci SAVEFILE harus muncul sebelum kata kunci DRIVER dalam string koneksi, atau hasilnya tidak akan ditentukan.

Pedoman Pengemudi Manager

Driver Manager membuat string koneksi untuk diteruskan ke driver dalam argumen InConnectionString dari fungsi SQLDriverConnect driver. Manajer Driver tidak memodifikasi argumen InConnectionString yang diteruskan kepadanya oleh aplikasi.

Tindakan Driver Manager didasarkan pada nilai argumen DriverComplete:

• SQL_DRIVER_PROMPT: Jika string koneksi tidak berisi kata kunci DRIVER,DSN, atau FILEDSN, Pengelola Driver menampilkan kotak dialog Sumber Data. Ini membangun string koneksi dari nama sumber data yang dikembalikan oleh kotak dialog dan kata kunci lain yang diteruskan kepadanya oleh aplikasi. Jika nama sumber data yang dikembalikan oleh kotak dialog kosong, Manajer Driver menentukan pasangan kata kunci-nilai DSN=Default. (Kotak dialog ini tidak akan menampilkan sumber data dengan nama "Default".)

• SQL_DRIVER_COMPLETE atau SQL_DRIVER_COMPLETE_REQUIRED: Jika string koneksi yang ditentukan oleh aplikasi menyertakan kata kunci DSN, Manajer Driver menyalin string koneksi yang ditentukan oleh aplikasi. Jika tidak, ia mengambil tindakan yang sama seperti saat DriverCompletion SQL_DRIVER_PROMPT.

• SQL_DRIVER_NOPROMPT: Pengelola Driver menyalin string koneksi yang ditentukan oleh aplikasi.

Jika string koneksi yang ditentukan oleh aplikasi berisi kata kunci DRIVER, Driver Manager menyalin string koneksi yang ditentukan oleh aplikasi.

Dengan menggunakan string koneksi yang telah dibuatnya, Driver Manager menentukan driver mana yang akan digunakan, terhubung ke driver tersebut, dan meneruskan string koneksi yang telah dibuatnya ke driver; untuk informasi selengkapnya tentang interaksi Driver Manager dan driver, lihat bagian "Komentar" di SQLConnect Function. Jika string koneksi tidak berisi kata kunci DRIVER, Driver Manager menentukan driver mana yang akan digunakan sebagai berikut:

1. Jika string koneksi berisi kata kunci DSN, Driver Manager mengambil driver yang terkait dengan sumber data dari informasi sistem.

2. Jika string koneksi tidak berisi kata kunci DSN atau sumber data tidak ditemukan, Driver Manager mengambil driver yang terkait dengan sumber data Default dari informasi sistem. (Untuk informasi selengkapnya, lihat Subkunci Default.) Driver Manager mengubah nilai kata kunci DSN dalam string koneksi menjadi "DEFAULT".

3. Jika kata kunci DSN dalam string koneksi diatur ke "DEFAULT", Driver Manager mengambil driver yang terkait dengan sumber data Default dari informasi sistem.

4. Jika sumber data tidak ditemukan dan sumber data Default tidak ditemukan, Pengelola Driver mengembalikan SQL_ERROR dengan SQLSTATE IM002 (Sumber data tidak ditemukan dan tidak ada driver default yang ditentukan).

Sumber File Data

Jika string koneksi yang ditentukan oleh aplikasi dalam panggilan ke SQLDriverConnect berisi kata kunci FILEDSN, dan kata kunci ini tidak digantikan oleh kata kunci DSN atau DRIVER, maka Driver Manager membuat string koneksi menggunakan informasi dalam file .dsn dan argumen InConnectionString. Manajer Pengemudi melanjutkan sebagai berikut:

1. Memeriksa apakah nama file file .dsn valid. Jika tidak, itu mengembalikan SQL_ERROR dengan SQLSTATE IM014 (Nama file DSN yang tidak valid). Jika nama file adalah string kosong ("") dan SQL_DRIVER_NOPROMPT tidak ditentukan, maka kotak dialog File-Open ditampilkan. Jika nama file berisi jalur yang valid tetapi tidak ada nama file atau nama file yang tidak valid, dan SQL_DRIVER_NOPROMPT tidak ditentukan, maka kotak dialog File-Open ditampilkan dengan direktori saat ini diatur ke yang ditentukan dalam nama file. Jika nama file adalah string kosong ("") atau nama file berisi jalur yang valid tetapi tidak ada nama file atau nama file yang tidak valid, dan SQL_DRIVER_NOPROMPT ditentukan, maka SQL_ERROR dikembalikan dengan SQLSTATE IM014 (Nama file DSN yang tidak valid).

2. Membaca semua kata kunci di bagian [ODBC] dari file .dsn. Jika kata kunci DRIVER tidak ada, kata kunci tersebut mengembalikan SQL_ERROR dengan SQLSTATE IM012 (Kesalahan sintaks kata kunci driver), kecuali jika file .dsn tidak dapat dibagikan dan dengan demikian hanya berisi kata kunci DSN .

   Jika sumber data file tidak dapat dibagikan, Pengelola Driver membaca nilai kata kunci DSN dan terhubung seperlunya ke sumber data pengguna atau sistem yang ditunjuk oleh sumber data file yang tidak dapat dibagikan. Langkah 3 hingga 5 tidak dilakukan.

3. Membuat string koneksi untuk driver. string koneksi driver adalah penyatuan kata kunci yang ditentukan dalam file .dsn dan yang ditentukan dalam string koneksi aplikasi asli. Aturan untuk konstruksi driver string koneksi di mana kata kunci tumpang tindih adalah sebagai berikut:

   • Jika kata kunci DRIVER ada di string koneksi aplikasi dan driver yang ditentukan oleh kata kunci DRIVER tidak sama dalam file .dsn dan string koneksi aplikasi, maka informasi driver dalam file .dsn diabaikan dan informasi driver dalam string koneksi aplikasi digunakan. Jika driver yang ditentukan oleh kata kunci DRIVER sama dalam file .dsn dan string koneksi aplikasi, maka di mana semua kata kunci tumpang tindih, yang ditentukan dalam string koneksi aplikasi memiliki prioritas daripada yang ditentukan dalam file .dsn.

   • Dalam string koneksi baru, kata kunci FILEDSN dihilangkan.

4. Memuat driver dengan melihat di entri registri HKEY_LOCAL_MACHINE\SOFTWARE\ODBC\ODBCINST.INI\<Nama Driver>\Driver di mana <Nama Driver> ditentukan oleh kata kunci DRIVER .

5. Meneruskan driver string koneksi baru.

Untuk contoh file .dsn, lihat Menyambungkan Menggunakan Sumber Data File.

Kata kunci SAVEFILE

Jika string koneksi yang ditentukan oleh aplikasi berisi kata kunci SAVEFILE, maka Driver Manager menyimpan string koneksi dalam file .dsn. Manajer Pengemudi melanjutkan sebagai berikut:

1. Memeriksa apakah nama file file .dsn yang disertakan sebagai nilai atribut kata kunci SAVEFILE valid. Jika tidak, itu mengembalikan SQL_ERROR dengan SQLSTATE IM014 (Nama file DSN yang tidak valid). Validitas nama file ditentukan oleh aturan penamaan sistem standar. Jika nama file adalah string kosong ("") dan argumen DriverCompletion tidak SQL_DRIVER_NOPROMPT, maka nama file tersebut valid. Jika nama file sudah ada, maka jika DriverCompletion SQL_DRIVER_NOPROMPT, file akan ditimpa. Jika DriverCompletion adalah SQL_DRIVER_PROMPT, SQL_DRIVER_COMPLETE, atau SQL_DRIVER_COMPLETE_REQUIRED, kotak dialog meminta pengguna untuk menentukan apakah file harus ditimpa. Jika Tidak dimasukkan, maka kotak dialog File-Save akan muncul.

2. Jika driver mengembalikan SQL_SUCCESS dan nama file bukan string kosong, maka Manajer Driver menulis informasi koneksi yang dikembalikan dalam argumen OutConnectionString ke file yang ditentukan dengan format yang ditentukan di bagian "String Koneksi" sebelumnya di bagian ini.

3. Jika driver mengembalikan SQL_SUCCESS dan nama file adalah string kosong (""), maka Driver Manager memanggil kotak dialog umum File-Save dengan hwnd yang ditentukan dan menulis informasi koneksi yang dikembalikan di OutConnectionString ke file yang ditentukan dalam kotak dialog umum File-Save dengan format yang ditentukan di bagian "String Koneksi" sebelumnya di bagian ini.

4. Jika driver mengembalikan SQL_SUCCESS, ia mengembalikan argumen OutConnectionString yang berisi string koneksi ke aplikasi.

5. Jika driver mengembalikan SQL_SUCCESS_WITH_INFO atau SQL_ERROR, maka Driver Manager mengembalikan SQLSTATE ke aplikasi.

Pedoman Pengemudi

Driver memeriksa apakah string koneksi yang diteruskan kepadanya oleh Driver Manager berisi kata kunci DSN atau DRIVER. Jika string koneksi berisi kata kunci DRIVER, driver tidak dapat mengambil informasi tentang sumber data dari informasi sistem. Jika string koneksi berisi kata kunci DSN atau tidak berisi kata kunci DSN atau DRIVER, driver dapat mengambil informasi tentang sumber data dari informasi sistem sebagai berikut:

1. Jika string koneksi berisi kata kunci DSN, driver mengambil informasi untuk sumber data yang ditentukan.

2. Jika string koneksi tidak berisi kata kunci DSN, sumber data yang ditentukan tidak ditemukan, atau kata kunci DSN diatur ke "DEFAULT", driver mengambil informasi untuk sumber data Default.

Driver menggunakan informasi apa pun yang diambil dari informasi sistem untuk menambah informasi yang diteruskan kepadanya dalam string koneksi. Jika informasi dalam informasi sistem menduplikasi informasi dalam string koneksi, driver menggunakan informasi dalam string koneksi.

Berdasarkan nilai DriverCompletion, driver meminta pengguna untuk informasi koneksi, seperti ID pengguna dan kata sandi, dan terhubung ke sumber data:

• SQL_DRIVER_PROMPT: Driver menampilkan kotak dialog, menggunakan nilai dari string koneksi dan informasi sistem (jika ada) sebagai nilai awal. Saat pengguna keluar dari kotak dialog, driver terhubung ke sumber data. Ini juga membuat string koneksi dari nilai kata kunci DSN atau DRIVER di *InConnectionString dan informasi yang dikembalikan dari kotak dialog. Ini menempatkan string koneksi ini di buffer *OutConnectionString.

• SQL_DRIVER_COMPLETE atau SQL_DRIVER_COMPLETE_REQUIRED: Jika string koneksi berisi informasi yang cukup, dan informasi tersebut benar, driver akan terhubung ke sumber data dan menyalin *InConnectionString ke *OutConnectionString. Jika ada informasi yang hilang atau salah, driver mengambil tindakan yang sama seperti yang dilakukan saat DriverCompletion SQL_DRIVER_PROMPT, kecuali bahwa jika DriverCompletion SQL_DRIVER_COMPLETE_REQUIRED, driver menonaktifkan kontrol untuk informasi apa pun yang tidak diperlukan untuk terhubung ke sumber data.

• SQL_DRIVER_NOPROMPT: Jika string koneksi berisi informasi yang cukup, driver terhubung ke sumber data dan menyalin *InConnectionString ke *OutConnectionString. Jika tidak, driver mengembalikan SQL_ERROR untuk SQLDriverConnect.

Pada koneksi yang berhasil ke sumber data, driver juga mengatur *StringLength2Ptr ke panjang string koneksi output yang tersedia untuk dikembalikan di *OutConnectionString.

Jika pengguna membatalkan kotak dialog yang disajikan oleh Driver Manager atau driver, SQLDriverConnect mengembalikan SQL_NO_DATA.

Untuk informasi tentang bagaimana Manajer Driver dan driver berinteraksi selama proses koneksi, lihat Fungsi SQLConnect.

Jika driver mendukung SQLDriverConnect, bagian kata kunci driver dari informasi sistem untuk driver harus berisi kata kunci ConnectFunctions dengan karakter kedua yang ditetapkan ke "Y".

Menghubungkan Saat Pengumpulan Koneksi Diaktifkan

Pengumpulan koneksi memungkinkan aplikasi untuk menggunakan kembali koneksi yang telah dibuat. Saat SQLDriverConnect dipanggil, Manajer Driver mencoba membuat koneksi menggunakan koneksi yang merupakan bagian dari kumpulan koneksi di lingkungan yang telah ditetapkan untuk pengumpulan koneksi. Untuk informasi selengkapnya tentang pengumpulan koneksi, lihat Fungsi SQLConnect.

Aplikasi dapat mengatur SQL_ATTR_RESET_CONNECTION sebelum memanggil SQLDisconnect pada koneksi tempat pengumpulan diaktifkan. Untuk informasi selengkapnya, lihat Fungsi SQLSetConnectAttr.

Pembatasan berikut berlaku saat aplikasi memanggil SQLDriverConnect untuk menyambungkan ke koneksi kumpulan:

• Tidak ada pemrosesan pengumpulan koneksi yang dilakukan saat kata kunci SAVEFILE ditentukan dalam string koneksi.

• Jika pengumpulan koneksi diaktifkan, SQLDriverConnect hanya dapat dipanggil dengan argumen DriverCompletion dari SQL_DRIVER_NOPROMPT; jika SQLDriverConnect dipanggil dengan DriverCompletion lainnya, SQLSTATE HY110 (Penyelesaian driver tidak valid) akan dikembalikan.

Atribut Koneksi

Atribut koneksi SQL_ATTR_LOGIN_TIMEOUT, diatur menggunakan SQLSetConnectAttr, menentukan jumlah detik untuk menunggu permintaan masuk selesai dengan koneksi yang berhasil oleh driver sebelum kembali ke aplikasi. Jika pengguna diminta untuk menyelesaikan string koneksi, masa tunggu untuk setiap permintaan login dimulai saat driver memulai proses koneksi.

Driver membuka koneksi dalam mode akses SQL_MODE_READ_WRITE secara default. Untuk mengatur mode akses ke SQL_MODE_READ_ONLY, aplikasi harus memanggil SQLSetConnectAttr dengan atribut SQL_ATTR_ACCESS_MODE sebelum memanggil SQLDriverConnect.

Jika pustaka terjemahan default ditentukan dalam informasi sistem untuk sumber data, driver akan memuatnya. Pustaka terjemahan yang berbeda dapat dimuat dengan memanggil SQLSetConnectAttr dengan atribut SQL_ATTR_TRANSLATE_LIB. Opsi terjemahan dapat ditentukan dengan memanggil SQLSetConnectAttr dengan opsi SQL_ATTR_TRANSLATE_OPTION.

Untuk informasi selengkapnya, lihat Menghubungkan dengan SQLDriverConnect.

// SQLDriverConnect_ref.cpp  
// compile with: odbc32.lib user32.lib  
#include <windows.h>  
#include <sqlext.h>  
  
int main() {  
   SQLHENV henv;  
   SQLHDBC hdbc;  
   SQLHSTMT hstmt;  
   SQLRETURN retcode;  
  
   SQLCHAR OutConnStr[255];  
   SQLSMALLINT OutConnStrLen;  
  
   HWND desktopHandle = GetDesktopWindow();   // desktop's window handle  
  
   // Allocate environment handle  
   retcode = SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv);  
  
   // Set the ODBC version environment attribute  
   if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
      retcode = SQLSetEnvAttr(henv, SQL_ATTR_ODBC_VERSION, (SQLPOINTER*)SQL_OV_ODBC3, 0);   
  
      // Allocate connection handle  
      if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
         retcode = SQLAllocHandle(SQL_HANDLE_DBC, henv, &hdbc);   
  
         // Set login timeout to 5 seconds  
         if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
            SQLSetConnectAttr(hdbc, SQL_LOGIN_TIMEOUT, (SQLPOINTER)5, 0);  
  
            retcode = SQLDriverConnect( // SQL_NULL_HDBC  
               hdbc,   
               desktopHandle,   
               (SQLCHAR*)"driver=SQL Server",   
               _countof("driver=SQL Server"),  
               OutConnStr,  
               255,   
               &OutConnStrLen,  
               SQL_DRIVER_PROMPT );  
  
            // Allocate statement handle  
            if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {                 
               retcode = SQLAllocHandle(SQL_HANDLE_STMT, hdbc, &hstmt);   
  
               // Process data  
               if (retcode == SQL_SUCCESS || retcode == SQL_SUCCESS_WITH_INFO) {  
                  SQLFreeHandle(SQL_HANDLE_STMT, hstmt);  
               }  
  
               SQLDisconnect(hdbc);  
            }  
  
            SQLFreeHandle(SQL_HANDLE_DBC, hdbc);  
         }  
      }  
      SQLFreeHandle(SQL_HANDLE_ENV, henv);  
   }  
}  

Lihat juga Contoh Program ODBC.

Fungsi Terkait

Lihat Juga

Referensi API ODBC
File Header ODBC