bcp_collen

Задает длину данных в переменной программы для текущей массовой копии в SQL Server.

Синтаксис

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

Аргументы

hdbc
Дескриптор соединения ODBC с поддержкой массового копирования.

cbData
Длина данных в переменной программы, не включая длину индикатора длины или конца. Параметр cbData для SQL_NULL_DATA указывает, что все строки, скопированные на сервер, содержат значение NULL для столбца. Параметр SQL_VARLEN_DATA указывает, что строковый терминатор или другой метод используется для определения длины скопированных данных. Если существуют индикатор длины и терминатор, система использует любой из них, что приводит к меньшему объему копирования данных.

idxServerCol
Порядковое положение столбца в таблице, в которой копируются данные. Первый столбец равен 1. Порядковый номер столбца возвращается функцией SQLColumns.

Возвраты

SUCCEED или FAIL.

Замечания

Функция bcp_collen позволяет изменить длину данных в переменной программы для определенного столбца при копировании данных в SQL Server с bcp_sendrow.

Изначально длина данных определяется при вызове bcp_bind . Если длина данных изменяется между вызовами bcp_sendrow и без префикса длины или конца, можно вызвать bcp_collen для сброса длины. Следующий вызов bcp_sendrow использует длину, заданную вызовом bcp_collen.

Необходимо вызывать bcp_collen один раз для каждого столбца в таблице, длина данных которой требуется изменить.

См. также

Функции массового копирования