bcp_colptr

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

Замечания

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

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

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

См. также

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