bcp_colptr
适用于：
SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)
将当前副本的程序变量数据地址设置为 SQL Server。
语法
RETCODE bcp_colptr (
HDBC hdbc,
LPCBYTE pData,
INT idxServerCol);
参数
hdbc
已启用大容量复制的 ODBC 连接句柄。
pData
指向要复制的数据的指针。 如果绑定数据类型是较大的值类型（如 SQLTEXT 或 SQLIMAGE）， pData 可以为 NULL。 NULL pData 指示将使用 bcp_moretext 以区块方式将长数据值发送到 SQL Server。
如果 pData 设置为 NULL，并且与绑定字段对应的列不是较大的值类型， 则bcp_colptr 失败。
有关大型值类型的详细信息，请参阅 bcp_bind。
idxServerCol
数据复制的目标数据库表中的列的序号位置。 表中的第一列为列 1。 SQLColumns 报告列的序号位置。
返回
SUCCEED 或 FAIL。
注解
bcp_colptr函数允许在将数据复制到具有bcp_sendrow的 SQL Server 时更改特定列的源数据的地址。
最初，通过调用 bcp_bind来设置指向用户数据的指针。 如果程序变量数据地址在调用 bcp_sendrow之间发生更改，则可以调用 bcp_colptr 来重置指向数据的指针。 下一次调用 bcp_sendrow 将调用寻址的数据发送到 bcp_colptr。
表中每个要修改其数据地址的列必须有单独的 bcp_colptr 调用。