SQLBindCol (Pustaka Kursor)

Penting

Fitur ini akan dihapus dalam versi Windows yang akan datang. Hindari menggunakan fitur ini dalam pekerjaan pengembangan baru dan rencanakan untuk memodifikasi aplikasi yang saat ini menggunakan fitur ini. Microsoft merekomendasikan penggunaan fungsionalitas kursor driver.

Topik ini membahas penggunaan fungsi SQLBindCol di pustaka kursor. Untuk informasi umum tentang SQLBindCol, lihat Fungsi SQLBindCol.

Aplikasi mengalokasikan satu atau beberapa buffer untuk pustaka kursor untuk mengembalikan set baris saat ini. Ini memanggil SQLBindCol satu atau beberapa kali untuk mengikat buffer ini ke kumpulan hasil.

Aplikasi dapat memanggil SQLBindCol untuk menggabungkan kembali kolom tataan hasil setelah disebut SQLExtendedFetch, SQLFetch, atau SQLFetchScroll, selama jenis data C, ukuran kolom, dan digit desimal kolom terikat tetap sama. Aplikasi tidak perlu menutup kursor untuk mengikat ulang kolom ke alamat yang berbeda.

Pustaka kursor mendukung pengaturan atribut pernyataan SQL_ATTR_ROW_BIND_OFFSET_PTR untuk menggunakan offset ikat. (SQLBindCol tidak perlu dipanggil agar pengikatan ulang ini terjadi.) Jika pustaka kursor digunakan dengan driver ODBC 3.x , offset ikatan tidak digunakan saat SQLFetch dipanggil. Offset ikatan digunakan jika SQLFetch dipanggil ketika pustaka kursor digunakan dengan driver ODBC 2.x karena SQLFetch kemudian dipetakan ke SQLExtendedFetch.

Pustaka kursor mendukung panggilan SQLBindCol untuk mengikat kolom bookmark.

Saat bekerja dengan driver ODBC 2.x , pustaka kursor mengembalikan SQLSTATE HY090 (String tidak valid atau panjang buffer) ketika SQLBindCol dipanggil untuk mengatur panjang buffer untuk kolom marka buku ke nilai yang tidak sama dengan 4. Saat bekerja dengan driver ODBC 3.x , pustaka kursor memungkinkan buffer untuk menjadi ukuran apa pun.