Data Kolom

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.

Pustaka kursor membuat buffer di cache untuk setiap buffer data yang terikat ke tataan hasil dengan SQLBindCol. Ini menggunakan nilai dalam buffer ini untuk membuat klausa WHERE saat meniru pernyataan pembaruan atau penghapusan yang diposisikan. Ini memperbarui buffer ini dari buffer set baris saat mengambil data dari sumber data dan ketika menjalankan pernyataan pembaruan yang diposisikan.

Ketika pustaka kursor memperbarui cache-nya dari buffer set baris, pustaka kursor mentransfer data sesuai dengan jenis data C yang ditentukan di SQLBindCol. Misalnya, jika jenis data C dari buffer set baris SQL_C_SLONG, pustaka kursor mentransfer empat byte data; jika SQL_C_CHAR dan BufferLength adalah 10, pustaka kursor mentransfer 10 byte data. Pustaka kursor tidak melakukan pemeriksaan jenis atau konversi apa pun pada data yang ditransfernya.

Catatan

Pustaka kursor tidak memperbarui cache untuk kolom jika *StrLen_or_IndPtr di buffer set baris yang sesuai SQL_DATA_AT_EXEC atau hasil makro SQL_LEN_DATA_AT_EXEC.

Saat memperbarui kolom, sumber data data kosong-pads data karakter panjang tetap dan data biner panjang tetap zero-pads seperlunya. Misalnya, sumber data menyimpan "Smith" di kolom CHAR(10) sebagai "Smith ". Pustaka kursor tidak mengosongkan data pad atau zero-pad di buffer set baris saat menyalin data ini ke cache setelah menjalankan pernyataan pembaruan yang diposisikan. Oleh karena itu, jika aplikasi mengharuskan nilai dalam cache pustaka kursor diisi kosong atau berpasangan nol, itu harus blank-pad atau zero-pad nilai dalam buffer set baris sebelum menjalankan pernyataan pembaruan yang diposisikan.