Mengalokasikan Handel Lingkungan
Tugas pertama untuk aplikasi ODBC apa pun adalah memuat Driver Manager; bagaimana hal ini dilakukan tergantung pada sistem operasi. Misalnya, pada komputer yang menjalankan Microsoft Windows NT Server/Windows 2000 Server, Windows NT Workstation/Windows 2000 Professional, atau Microsoft Windows 95/98, aplikasi menautkan ke pustaka Driver Manager atau memanggil LoadLibrary untuk memuat DLL Manajer Driver.
Tugas berikutnya, yang harus dilakukan sebelum aplikasi dapat memanggil fungsi ODBC lainnya, adalah menginisialisasi lingkungan ODBC dan mengalokasikan handel lingkungan, sebagai berikut:
Aplikasi ini mendeklarasikan variabel jenis SQLHENV. Kemudian memanggil SQLAllocHandle dan meneruskan alamat variabel ini dan opsi SQL_HANDLE_ENV. Misalnya:
SQLHENV henv1; SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv1);Driver Manager mengalokasikan struktur untuk menyimpan informasi tentang lingkungan, dan mengembalikan handel lingkungan 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 ion, nanti di bagian ini.
Setelah aplikasi selesai menggunakan ODBC, aplikasi membebaskan handel lingkungan dengan SQLFreeHandle. Setelah membebaskan lingkungan, ini adalah kesalahan pemrograman aplikasi untuk menggunakan handel lingkungan dalam panggilan ke fungsi ODBC; melakukannya memiliki konsekuensi yang tidak terdefinisi tetapi mungkin fatal.
Ketika SQLFreeHandle dipanggil, driver merilis struktur yang digunakan untuk menyimpan informasi tentang lingkungan. Perhatikan bahwa SQLFreeHandle tidak dapat dipanggil untuk handel lingkungan hingga setelah semua handel koneksi pada handel lingkungan tersebut telah dibebaskan.
Untuk informasi selengkapnya tentang penanganan lingkungan, lihat Handel Lingkungan.