Share via

bcp_colptr

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics 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 调用。

另请参阅

大容量复制函数