将一行数据从程序变量发送到 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)。