Apa yang Dilakukan Driver
Tabel berikut ini meringkas fungsi dan pernyataan apa yang harus diterapkan driver ODBC 3.x untuk kursor yang dapat diblokir dan dapat digulir.
| Fungsi atau atribut pernyataan |
Komentar |
|---|---|
| SQL_ATTR_ROW_STATUS_PTR | Mengatur alamat array status baris yang diisi oleh SQLFetch dan SQLFetchScroll. Array ini juga diisi oleh SQLSetPos jika SQLSetPos dipanggil dalam status pernyataan S6. Jika SQLSetPos dipanggil dalam status S7, array ini tidak diisi tetapi array yang diarahkan oleh argumen RowStatusArray dari SQLExtendedFetch diisi. Untuk informasi selengkapnya, lihat Transisi Pernyataan di Lampiran B: Tabel Transisi Status ODBC. |
| SQL_ATTR_ROWS_FETCHED_PTR | Mengatur alamat buffer tempat SQLFetch dan SQLFetchScroll mengembalikan jumlah baris yang diambil. Jika SQLExtendedFetch dipanggil, buffer ini tidak diisi tetapi argumen RowCountPtr menunjuk ke jumlah baris yang diambil. |
| SQL_ATTR_ROW_ARRAY_SIZE | Mengatur ukuran set baris yang digunakan oleh SQLFetch dan SQLFetchScroll. |
| SQL_ROWSET_SIZE | Mengatur ukuran set baris yang digunakan oleh SQLExtendedFetch. Driver ODBC 3.x menerapkan ini jika mereka ingin bekerja dengan aplikasi ODBC 2.x yang memanggil SQLExtendedFetch atau SQLSetPos. |
| SQLBulkOperations | Jika driver ODBC 3.x harus bekerja dengan aplikasi ODBC 2.x yang menggunakan SQLSetPos dengan Operasi SQL_ADD, driver harus mendukung SQLSetPos dengan Operasi SQL_ADD selain SQLBulkOperations dengan Operasi SQL_ADD. |
| SQLExtendedFetch | Mengembalikan set baris yang ditentukan. Driver ODBC 3.x menerapkan ini jika mereka ingin bekerja dengan aplikasi ODBC 2.x yang memanggil SQLExtendedFetch atau SQLSetPos. Berikut ini adalah detail implementasi: - Driver mengambil ukuran set baris dari nilai atribut pernyataan SQL_ROWSET_SIZE. - Driver mengambil alamat array status baris dari argumen RowStatusArray , bukan atribut pernyataan SQL_ATTR_ROW_STATUS_PTR. Argumen RowStatusArray dalam panggilan ke SQLExtendedFetch tidak boleh berupa pointer null. (Perhatikan bahwa dalam ODBC 3.x, atribut pernyataan SQL_ATTR_ROW_STATUS_PTR dapat berupa pointer null.) - Driver mengambil alamat baris yang diambil buffer dari argumen RowCountPtr , bukan atribut pernyataan SQL_ATTR_ROWS_FETCHED_PTR. - Driver mengembalikan SQLSTATE 01S01 (Kesalahan berturut-turut) untuk menunjukkan bahwa kesalahan telah terjadi saat baris diambil oleh panggilan ke SQLExtendedFetch. Driver ODBC 3.x harus mengembalikan SQLSTATE 01S01 (Kesalahan berturut-turut) hanya ketika SQLExtendedFetch dipanggil, bukan ketika SQLFetch atau SQLFetchScroll dipanggil. Untuk mempertahankan kompatibilitas mundur, ketika SQLSTATE 01S01 (Kesalahan berturut-turut) dikembalikan oleh SQLExtendedFetch, Manajer Driver tidak memesan rekaman status dalam antrean kesalahan sesuai dengan aturan yang dinyatakan di bagian "Urutan Rekaman Status" dari SQLGetDiagField. |
| SQLFetch | Mengembalikan set baris berikutnya. Berikut ini adalah detail implementasi: - Driver mengambil ukuran set baris dari nilai atribut pernyataan SQL_ATTR_ROW_ARRAY_SIZE. - Driver mengambil alamat array status baris dari atribut pernyataan SQL_ATTR_ROW_STATUS_PTR. - Driver mengambil alamat baris yang diambil buffer dari atribut pernyataan SQL_ATTR_ROWS_FETCHED_PTR. - Aplikasi ini dapat mencampur panggilan antara SQLFetchScroll dan SQLFetch. - SQLFetch mengembalikan marka buku jika kolom 0 terikat. - SQLFetch dapat dipanggil untuk mengembalikan lebih dari satu baris. - Driver tidak mengembalikan SQLSTATE 01S01 (Kesalahan berturut-turut) untuk menunjukkan bahwa kesalahan telah terjadi saat baris diambil oleh panggilan ke SQLFetch. |
| SQLFetchScroll | Mengembalikan set baris yang ditentukan. Berikut ini adalah detail implementasi: - Driver mengambil ukuran set baris dari atribut pernyataan SQL_ATTR_ROW_ARRAY_SIZE. - Driver mengambil alamat array status baris dari atribut pernyataan SQL_ATTR_ROW_STATUS_PTR. - Driver mengambil alamat baris yang diambil buffer dari atribut pernyataan SQL_ATTR_ROWS_FETCHED_PTR. - Aplikasi ini dapat mencampur panggilan antara SQLFetchScroll dan SQLFetch. - Driver tidak mengembalikan SQLSTATE 01S01 (Kesalahan berturut-turut) untuk menunjukkan bahwa kesalahan telah terjadi saat baris diambil oleh panggilan ke SQLFetchScroll. |
| SQLSetPos | Melakukan berbagai operasi yang diposisikan. Berikut ini adalah detail implementasi: - Ini dapat dipanggil dalam pernyataan menyatakan S6 atau S7. Untuk detail selengkapnya, lihat Transisi Pernyataan di Lampiran B: Tabel Transisi Status ODBC. - Jika ini dipanggil dalam status pernyataan S5 atau S6, driver mengambil ukuran set baris dari atribut pernyataan SQL_ATTR_ROWS_FETCHED_PTR dan alamat array status baris dari atribut pernyataan SQL_ATTR_ROW_STATUS_PTR. - Jika ini disebut dalam status pernyataan S7, driver mengambil ukuran set baris dari atribut pernyataan SQL_ROWSET_SIZE dan alamat array status baris dari argumen RowStatusArray dari SQLExtendedFetch. - Driver mengembalikan SQLSTATE 01S01 (Kesalahan berturut-turut) hanya untuk menunjukkan bahwa kesalahan telah terjadi saat baris diambil oleh panggilan ke SQLSetPos untuk melakukan operasi massal ketika fungsi dipanggil dalam status S7. Untuk mempertahankan kompatibilitas mundur, jika SQLSTATE 01S01 (Kesalahan berturut-turut) dikembalikan oleh SQLSetPos, Manajer Driver tidak memesan rekaman status dalam antrean kesalahan sesuai dengan aturan yang dinyatakan di bagian "Urutan Rekaman Status" dari SQLGetDiagField. - Jika driver harus bekerja dengan aplikasi ODBC 2.x yang memanggil SQLSetPos dengan argumen Operasi SQL_ADD, driver harus mendukung SQLSetPos dengan argumen Operasi SQL_ADD. |
Saran dan Komentar
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat: https://aka.ms/ContentUserFeedback.
Kirim dan lihat umpan balik untuk