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_batchbcp_done时才会提交行。 用户可以选择每 n 行调用一次bcp_batch,或者在传入数据的时间段之间出现空位时。 如果从未调用 bcp_batch ,则会在调用 bcp_done 时提交行。

有关从 SQL Server 2005 开始的大容量复制中断性变更的信息,请参阅执行大容量复制作(ODBC)。

另请参阅

大容量复制函数