bcp_collen

Define o comprimento de dados na variável de programa para a cópia em massa atual no SQL Server.

Sintaxe

RETCODE bcp_collen ( 
        HDBC hdbc, 
        DBINT cbData, 
        INT idxServerCol);

Argumentos

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

  • cbData
    É o comprimento dos dados na variável de programa, não incluindo o comprimento dos indicadores ou terminadores de comprimento. A definição de cbData como SQL_NULL_DATA indica que todas as linhas copiadas no servidor contêm um valor NULL na coluna. Defini-lo como SQL_VARLEN_DATA indica que um terminador da cadeia de caracteres ou outro método é usado para determinar o comprimento dos dados copiados. Se um indicador de comprimento e um terminador existirem, o sistema usará o que resultar em menos cópia de dados.

  • idxServerCol
    É a posição ordinal da coluna na tabela na qual os dados são copiados. A primeira coluna é 1. A posição ordinal de uma coluna é relatada por SQLColumns.

Retorna

SUCCEED ou FAIL.

Comentários

A função bcp_collen permite que você altere o comprimento de dados na variável do programa para uma coluna específica quando copiar dados no SQL Server com bcp_sendrow.

Inicialmente, o comprimento de dados é determinado quando bcp_bind é chamado. Se o comprimento de dados for alterado entre as chamadas para bcp_sendrow e nenhum prefixo de comprimento ou terminador for usado, você poderá chamar bcp_collen para redefinir o comprimento. A próxima chamada para bcp_sendrow usará o comprimento definido pela chamada para bcp_collen.

Você deve chamar bcp_collen uma vez para cada coluna na tabela cujo comprimento de dados deseje modificar.

Consulte também

Referência

Funções de cópia em massa