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


bcp_collen

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

Синтаксис

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

Arguments

  • 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.

См. также

Справочник