Compartir a través de


bcp_sendrow

Envía una fila de datos de las variables de programa a SQL Server. 

Sintaxis

RETCODE bcp_sendrow ( 
    HDBC hdbc);

Argumentos

  • hdbc
    Es el identificador de la conexión ODBC habilitado para la copia masiva.

Devuelve

SUCCEED o FAIL.

Comentarios

La función bcp_sendrow genera una fila a partir de las variables de programa y la envía a SQL Server.

Antes de llamar a a bcp_sendrow, debe hacer llamadas a bcp_bind para especificar las variables de programa que contienen los datos de la fila.

Si se llama a bcp_bind especificando un tipo de datos largo, de longitud variable, por ejemplo un parámetro eDataType de SQLTEXT y un parámetro pData no NULL, bcp_sendrow envía el valor entiredata, igual que para cualquier otro tipo de datos. Si, no obstante, bcp_bind tiene un parámetro pData NULL, bcp_sendrow devuelve inmediatamente el control a la aplicación inmediatamente después de enviar todas las columnas con datos especificados a SQL Server. A continuación, la aplicación puede llamar repetidamente a bcp_moretext para enviar los datos largos, de longitud variable a SQL Server, un fragmento a la vez. Para obtener más información, vea bcp_moretext.

Cuando se utiliza bcp_sendrow para la copia masiva de filas de variables de programa en tablas SQL Server, las filas solamente se confirman cuando el usuario llama a a bcp_batch o a bcp_done. El usuario puede elegir llamar a bcp_batch una vez cada n filas o cuando haya un periodo de inactividad entre períodos de entrada de datos. Si nunca se llama a bcp_batch, las filas se confirman cuando se llama a bcp_done.

Para obtener información sobre cambios importantes en la copia masiva a partir de SQL Server 2005, vea Realizar operaciones de copia masiva (ODBC).

Vea también

Referencia

Funciones de copia masiva