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

Pustaka kursor mendukung atribut pernyataan berikut dengan SQLSetStmtAttr:

SQL_ATTR_CONCURRENCY
SQL_ATTR_CURSOR_TYPE
SQL_ATTR_FETCH_BOOKMARK_PTR
SQL_ATTR_PARAM_BIND_OFFSET_PTR
SQL_ATTR_PARAM_BIND_TYPE

SQL_ATTR_ROW_BIND_OFFSET_PTR
SQL_ATTR_ROW_BIND_TYPE
SQL_ATTR_ROWSET_ARRAY_SIZE
SQL_ATTR_SIMULATE_CURSOR
SQL_ATTR_USE_BOOKMARKS

Pustaka kursor hanya mendukung nilai SQL_CURSOR_FORWARD_ONLY dan SQL_CURSOR_STATIC atribut pernyataan SQL_ATTR_CURSOR_TYPE.

Untuk kursor khusus penerusan, pustaka kursor mendukung nilai SQL_CONCUR_READ_ONLY atribut pernyataan SQL_ATTR_CONCURRENCY. Untuk kursor statis, pustaka kursor mendukung nilai SQL_CONCUR_READ_ONLY dan SQL_CONCUR_VALUES atribut pernyataan SQL_ATTR_CONCURRENCY.

Pustaka kursor hanya mendukung nilai SQL_SC_NON_UNIQUE atribut pernyataan SQL_ATTR_SIMULATE_CURSOR.

Meskipun spesifikasi ODBC mendukung panggilan ke SQLSetStmtAttr dengan atribut SQL_ATTR_PARAM_BIND_TYPE atau SQL_ATTR_ROW_BIND_TYPE setelah SQLFetch atau SQLFetchScroll dipanggil, pustaka kursor tidak. Sebelum dapat mengubah jenis pengikatan di pustaka kursor, aplikasi harus menutup kursor. Pustaka kursor mendukung perubahan atribut pernyataan SQL_ATTR_ROW_BIND_OFFSET_PTR, SQL_ATTR_PARAM_BIND_OFFSET_PTR, SQL_ATTR_ROWS_FETCHED_PTR, dan SQL_ATTR_PARAMS_PROCESSED_PTR saat kursor terbuka.

Aplikasi dapat memanggil SQLSetStmtAttr dengan Atribut SQL_ATTR_ROW_ARRAY_SIZE untuk mengubah ukuran set baris saat kursor terbuka. Ukuran set baris baru akan berlaku saat berikutnya SQLFetchScroll atau SQLFetch dipanggil.

Pustaka kursor mendukung pengaturan atribut pernyataan SQL_ATTR_PARAM_BIND_OFFSET_PTR atau SQL_ATTR_ROW_BIND_OFFSET_PTR untuk mengaktifkan offset pengikatan. Offset pengikatan tidak akan digunakan untuk panggilan ke SQLFetch ketika pustaka kursor digunakan dengan ODBC 2.x driver.

Pustaka kursor mendukung pengaturan atribut pernyataan SQL_ATTR_USE_BOOKMARKS ke SQL_UB_VARIABLE.