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


bcp_colptr

Применимо: SQL Server База данных SQL Azure Управляемый экземпляр SQL Azure azure Synapse Analytics Analytics Platform System (PDW)

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

См. также

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