bcp_sendrow

Envia uma linha de dados de variáveis de programa para o SQL Server. 

Sintaxe

RETCODE bcp_sendrow ( 
    HDBC hdbc);

Argumentos

  • hdbc
    É o identificador de conexão ODBC habilitado para cópia em massa.

Retorna

SUCCEED ou FAIL.

Comentários

A função bcp_sendrow compila uma linha de variáveis de programa e a envia para o SQL Server.

Antes de chamar bcp_sendrow, você deve fazer chamadas para bcp_bind para especificar as variáveis de programa que contêm os dados da linha.

Caso bcp_bind seja chamado especificando um tipo de dados longo de comprimento variável, por exemplo um parâmetro eDataType de SQLTEXT e um parâmetro pData diferente de NULL, bcp_sendrow envia todo o valor de dados, exatamente como faz para qualquer outro tipo de dados. Entretanto, se bcp_bind tiver um parâmetro pData igual a NULL, bcp_sendrow retorna o controle para o aplicativo imediatamente após todas as colunas com os dados especificados serem enviadas ao SQL Server. Então, o aplicativo pode chamar bcp_moretext repetidamente para enviar os dados longos de comprimento variável para SQL Server, uma parte de cada vez. Para obter mais informações, consulte bcp_moretext.

Quando bcp_sendrow for usado para copiar linhas em massa de variáveis do programa para tabelas do SQL Server, as linhas são confirmadas somente quando o usuário chamar bcp_batch ou bcp_done. O usuário pode escolher chamar bcp_batch uma vez a cada n linhas ou quando houver uma pausa entre períodos de dados de entrada. Se bcp_batch nunca for chamado, as linhas serão confirmadas quando bcp_done for chamado.

Para obter informações sobre uma alteração de quebra na cópia em massa a partir do SQL Server 2005, consulte Executando operações de cópia em massa (ODBC).

Consulte também

Referência

Funções de cópia em massa