Offset Pengikatan Parameter

Aplikasi dapat menentukan bahwa offset ditambahkan ke alamat buffer parameter terikat dan panjang/alamat buffer indikator yang sesuai saat SQLExecDirect atau SQLExecute dipanggil. Hasil penambahan ini menentukan alamat yang digunakan dalam operasi ini.

Offset bind memungkinkan aplikasi mampu mengubah pengikatan tanpa memanggil SQLBindParameter untuk parameter yang sebelumnya terikat. Panggilan ke SQLBindParameter untuk mengikat ulang parameter mengubah alamat buffer dan penunjuk panjang/indikator. Pengikatan kembali dengan offset, di sisi lain, hanya menambahkan offset pada alamat buffer parameter yang sudah terikat serta alamat buffer panjang/indikator. Ketika offset digunakan, pengikatan adalah "templat" tentang bagaimana buffer aplikasi ditata dan aplikasi dapat memindahkan "templat" ini ke area memori yang berbeda dengan mengubah offset. Offset baru dapat ditentukan kapan saja dan selalu ditambahkan ke nilai yang awalnya terikat.

Untuk menetapkan bind offset, aplikasi mengatur atribut pernyataan SQL_ATTR_PARAM_BIND_OFFSET_PTR ke alamat buffer SQLINTEGER. Sebelum aplikasi memanggil fungsi yang menggunakan pengikatan, aplikasi menempatkan offset dalam byte di buffer ini, selama baik alamat buffer parameter maupun alamat buffer panjang/indikator tidak 0, dan parameter terikat terdapat dalam pernyataan SQL. Penjumlahan alamat dan offset harus berupa alamat yang valid. Ini berarti bahwa baik offset maupun alamat yang ditambahkan dengan offset bisa jadi tidak valid, selama jumlahnya adalah alamat yang valid.

Nota

Offset pengikatan tidak didukung oleh driver ODBC 2.x.