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


bcp_colptr

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

Синтаксис

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

Аргументы

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

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

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

Дополнительные сведения о типах больших значений см. в разделе bcp_bind.

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

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

SUCCEED или FAIL.

Комментарии

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

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

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

См. также:

Bulk Copy Functions