通过

bcp_colptr

  • 项目

适用于：SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics 平台系统（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 调用。

另请参阅

大容量复制函数