SQLSetConnectAttr (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 SQLSetConnectAttr di pustaka kursor. Untuk informasi umum tentang SQLSetConnectAttr, lihat Fungsi SQLSetConnectAttr.

Aplikasi memanggil SQLSetConnectAttr dengan atribut SQL_ATTR_ODBC_CURSORS untuk menentukan apakah pustaka kursor selalu digunakan, digunakan jika driver tidak mendukung kursor yang dapat digulir, atau tidak pernah digunakan. Pustaka kursor mengasumsikan bahwa driver mendukung kursor yang dapat digulir jika mengembalikan SQL_CA1_RELATIVE untuk jenis informasi SQL_STATIC_CURSOR_ATTRIBUTES1 di SQLGetInfo.

Aplikasi harus memanggil SQLSetConnectAttr untuk menentukan penggunaan pustaka kursor setelah memanggil SQLAllocHandle dengan HandleType SQL_HANDLE_DBC untuk mengalokasikan koneksi dan sebelum tersambung ke sumber data. Jika aplikasi memanggil SQLSetConnectAttr dengan atribut SQL_ATTR_ODBC_CURSORS saat koneksi masih aktif, pustaka kursor mengembalikan kesalahan.

Untuk mengatur atribut pernyataan yang didukung oleh pustaka kursor untuk semua pernyataan yang terkait dengan koneksi, aplikasi harus memanggil SQLSetConnectAttr untuk atribut pernyataan tersebut setelah tersambung ke sumber data dan sebelum membuka kursor. Jika aplikasi memanggil SQLSetConnectAttr dengan atribut pernyataan dan kursor terbuka pada pernyataan yang terkait dengan koneksi, atribut pernyataan tidak akan diterapkan ke pernyataan tersebut sampai kursor ditutup dan dibuka kembali.