bcp_collen

Статья
05/07/2013

Устанавливает длину данных в переменной программы для текущего массового копирования в 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.

См. также

Справочник

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

Поделиться через