bcp_collen

为目标为 SQL Server 的当前大容量复制设置程序变量中的数据长度。

语法

RETCODE bcp_collen (
        HDBC hdbc,
        DBINT cbData,
        INT idxServerCol);

参数

  • hdbc
    支持大容量复制的 ODBC 连接句柄。

  • cbData
    程序变量中数据的长度,不包括任何长度指示器或终止符的长度。将 cbData 设置为 SQL_NULL_DATA 指示复制到服务器的所有行都针对该列包含一个 NULL 值;设置为 SQL_VARLEN_DATA 则指示使用字符串终止符或其他方法确定复制的数据的长度。如果同时提供长度指示器和终止符,系统将使用二者中复制数据量较少的一个。

  • idxServerCol
    数据复制到的表中的列的序号位置。第一列为 1。列的序号位置由 SQLColumns 报告。

返回值

SUCCEED 或 FAIL。

注释

bcp_collen 函数允许在使用 bcp_sendrow 将数据复制到 SQL Server 时,更改特定列的程序变量中的数据长度。

最初,数据长度是在调用 bcp_bind 后确定的。如果数据长度在两次调用 bcp_sendrow 之间发生了更改,并且未使用长度前缀或终止符,则可以通过调用 bcp_collen 重置该长度。下一次调用 bcp_sendrow 将使用通过调用 bcp_collen 设置的长度。

必须对要修改数据长度的表中的每一列都调用一次 bcp_collen

请参阅

参考