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.

Devoluções

SUCCEED ou FAIL.

Observações

A função bcp_sendrow cria uma linha a partir 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 dados de linha.

Se bcp_bind for chamado especificando um tipo de dados de comprimento variável longo, por exemplo, um parâmetro eDataType de SQLTEXT e um parâmetro pData nãoNULL, bcp_sendrow enviará o valor inteiro, assim como faz para qualquer outro tipo de dados. Se, no entanto, bcp_bind tiver um parâmetro nulo pData , bcp_sendrow retornará o controle para o aplicativo imediatamente após todas as colunas com dados especificados serem enviadas ao SQL Server. Em seguida, o aplicativo pode chamar bcp_moretext repetidamente para enviar os dados longos e de comprimento variável para o SQL Server, uma parte de cada vez. Para obter mais informações, consulte bcp_moretext.

Quando bcp_sendrow é usado para copiar em massa linhas de variáveis de programa em tabelas do SQL Server, as linhas são confirmadas somente quando o usuário chama bcp_batch ou bcp_done. O usuário pode optar por 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 significativa na cópia em massa a partir do SQL Server 2005, consulte executar operações de cópia em massa (ODBC).

Consulte Também

Funções de cópia em massa