将一行数据从程序变量发送到SQL Server。
语法
RETCODE bcp_sendrow (
HDBC
hdbc
);
参数
hdbc
已启用大容量复制的 ODBC 连接句柄。
返回
SUCCEED 或 FAIL。
备注
bcp_sendrow 函数从程序变量生成一行,并将其发送到SQL Server。
在调用 bcp_sendrow之前,必须调用 bcp_bind 以指定包含行数据的程序变量。
如果调用 bcp_bind 指定一个长度可变的长数据类型(例如,SQLTEXT 的 eDataType 参数和 nonNULL 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) (大容量复制操作。