bcp_colptr

将当前副本的程序变量数据地址设置到 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

请参阅

参考