bcp_sendrow
Envia uma linha de dados de variáveis de programa para SQL Server.
Sintaxe
RETCODE bcp_sendrow (
HDBC
hdbc
);
Argumentos
hdbc
É o identificador de conexão ODBC habilitado para cópia em massa.
Retornos
SUCCEED ou FAIL.
Comentários
A função bcp_sendrow cria uma linha de variáveis de programa e a envia para 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. Se, no entanto, bcp_bind tiver um parâmetro pData NULL, bcp_sendrow retornará o controle para o aplicativo imediatamente depois que todas as colunas com dados especificados forem enviadas para SQL Server. Em seguida, 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 é usado para copiar linhas em massa de variáveis de programa para tabelas SQL Server, as linhas são confirmadas somente quando o usuário chama 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 interruptiva na cópia em massa a partir do SQL Server 2005, consulte Executando operações de cópia em massa (ODBC).