bcp_sendrow
将一行数据从程序变量发送到 SQL Server。
语法
RETCODE bcp_sendrow (
HDBC hdbc);
参数
- hdbc
支持大容量复制的 ODBC 连接句柄。
返回值
SUCCEED 或 FAIL。
注释
bcp_sendrow 函数从程序变量生成一行并将其发送到 SQL Server。
在调用 bcp_sendrow 之前，必须调用 bcp_bind 以指定包含行数据的程序变量。
如果调用 bcp_bind 指定了长度可变的长整型数据类型，例如 SQLTEXT 的 eDataType 参数和非 NULL pData 参数，则 bcp_sendrow 发送整个数据值，就像它发送任何其他数据类型一样。如果 bcp_bind 具有 NULL pData 参数，则 bcp_sendrow 在将所有具有指定数据的列发送到 SQL Server 之后立即将控制权返回给应用程序。应用程序然后可以重复调用 bcp_moretext 以将长度可变的长整型数据发送到 SQL Server，一次发送一个块区。有关详细信息，请参阅 bcp_moretext。
当使用 bcp_sendrow 来将行从程序变量大容量复制到 SQL Server 表时，仅当用户调用 bcp_batch 或 bcp_done 时才提交行。用户可以选择每 n 行调用一次 bcp_batch，或在传入数据的间歇期调用它。如果从不调用 bcp_batch，则在调用 bcp_done 时提交行。
有关从 SQL Server 2005 开始的针对大容量复制的重要更改的信息，请参阅执行大容量复制操作 (ODBC)。