Bagikan melalui


bcp_colptr

Berlaku untuk: SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)

Mengatur alamat data variabel program untuk salinan saat ini ke SQL Server.

Sintaks

  
RETCODE bcp_colptr (  
        HDBC hdbc,  
        LPCBYTE pData,  
        INT idxServerCol);  

Argumen

hdbc
Adalah handel koneksi ODBC yang mendukung penyalinan massal.

pData
Adalah penunjuk ke data yang akan disalin. Jika jenis data terikat adalah jenis nilai besar (seperti SQLTEXT atau SQLIMAGE), pData dapat berupa NULL. PData NULL menunjukkan nilai data panjang akan dikirim ke SQL Server dalam gugus menggunakan bcp_moretext.

Jika pData diatur ke NULL dan kolom yang sesuai dengan bidang terikat bukan jenis nilai besar, bcp_colptr gagal.

Untuk informasi selengkapnya tentang jenis nilai besar, lihat bcp_bind.

idxServerCol
Adalah posisi ordinal kolom dalam tabel database tempat data disalin. Kolom pertama dalam tabel adalah kolom 1. Posisi ordinal kolom dilaporkan oleh SQLColumns.

Mengembalikan

BERHASIL atau GAGAL.

Keterangan

Fungsi bcp_colptr memungkinkan Anda mengubah alamat data sumber untuk kolom tertentu saat menyalin data ke SQL Server dengan bcp_sendrow.

Awalnya, penunjuk ke data pengguna diatur oleh panggilan ke bcp_bind. Jika alamat data variabel program berubah antara panggilan ke bcp_sendrow, Anda dapat memanggil bcp_colptr untuk mengatur ulang penunjuk ke data. Panggilan berikutnya ke bcp_sendrow mengirim data yang ditangani oleh panggilan ke bcp_colptr.

Harus ada panggilan bcp_colptr terpisah untuk setiap kolom dalam tabel yang alamat datanya ingin Anda ubah.

Lihat Juga

Fungsi Salin Massal