bcp_collen

Define o comprimento dos 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 de qualquer indicador de comprimento ou terminador. Definir cbData como SQL_NULL_DATA indica que todas as linhas copiadas para o servidor contêm um valor NULL para a coluna. Defini-lo como SQL_VARLEN_DATA indica que um terminador de cadeia de caracteres ou outro método é usado para determinar o comprimento dos dados copiados. Se houver um indicador de comprimento e um terminador, o sistema usará qualquer um que resulte em menos dados sendo copiados.

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

Devoluções

SUCCEED ou FAIL.

Observações

A função bcp_collen permite alterar o comprimento dos dados na variável de programa para uma coluna específica ao copiar dados para o SQL Server com bcp_sendrow.

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

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

Consulte Também

Funções de cópia em massa