bcp_colptr

Статья
05/07/2013

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

Синтаксис

RETCODE bcp_colptr ( 
        HDBC hdbc, 
        LPCBYTE pData, 
        INT idxServerCol);

Аргументы

hdbc
Дескриптор соединения ODBC с поддержкой массового копирования.
pData
Указатель на копируемые данные. Если тип привязанных данных является типом больших значений (например SQLTEXT или SQLIMAGE), то аргумент pData может иметь значение NULL. Если аргумент pData имеет значение NULL, данные большого объема будут отправлены в виде фрагментов данных на SQL Server с помощью функции bcp_moretext.

Если аргумент pData имеет значение NULL и столбец, соответствующий привязанному полю, не является типом больших значений функция bcp_colptr завершается с ошибкой.

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

Возвращаемое значение

SUCCEED или FAIL.

Замечания

При копировании данных в SQL Server с помощью bcp_sendrow, функция bcp_colptr позволяет изменять адрес источника данных для определенного столбца.

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

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

См. также

Справочник

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

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