Mengalokasikan Pengendali Koneksi ODBC

Sebelum aplikasi dapat terhubung ke sumber data atau driver, aplikasi harus mengalokasikan handel koneksi, sebagai berikut:

1. Aplikasi mendeklarasikan variabel jenis SQLHDBC. Kemudian memanggil SQLAllocHandle dan meneruskan alamat variabel ini, handel lingkungan untuk mengalokasikan koneksi, dan opsi SQL_HANDLE_DBC. Contohnya:

   SQLHDBC hdbc1;  
   
   SQLAllocHandle(SQL_HANDLE_DBC, henv1, &hdbc1);  
   

2. Driver Manager mengalokasikan struktur untuk menyimpan informasi tentang perintah dan mengembalikan handle koneksi ke dalam variabel.

Manajer Driver tidak memanggil SQLAllocHandle pada driver saat ini karena tidak tahu driver mana yang akan dipanggil. Ini menunda panggilan SQLAllocHandle di driver sampai aplikasi memanggil fungsi untuk terhubung ke sumber data. Untuk informasi selengkapnya, lihat Peran Manajer Driver dalam Proses Koneksi, nanti di bagian ini.

Penting untuk diingat bahwa mengalokasikan handle koneksi tidak sama dengan memuat driver. Driver tidak dimuat sampai fungsi koneksi dipanggil. Dengan demikian, setelah mengalokasikan handel koneksi dan sebelum menyambungkan ke driver atau sumber data, satu-satunya fungsi yang dapat dipanggil aplikasi dengan handel koneksi adalah SQLSetConnectAttr, SQLGetConnectAttr, atau SQLGetInfo dengan opsi SQL_ODBC_VER. Memanggil fungsi lain dengan handel koneksi, seperti SQLEndTran, mengembalikan SQLSTATE 08003 (Koneksi tidak terbuka). Untuk detail selengkapnya, lihat Lampiran B: Tabel Transisi Status ODBC.

Untuk informasi selengkapnya tentang pegangan koneksi, lihat Pegangan Koneksi.