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).