bcp_sendrow
Отправляет строку данных из переменных программы в SQL Server.
Синтаксис
RETCODE bcp_sendrow (
HDBC hdbc);
Аргументы
- hdbc
Дескриптор соединения ODBC с поддержкой массового копирования.
Возвращаемое значение
SUCCEED или FAIL.
Замечания
Функция bcp_sendrow формирует строку из переменных программы и отправляет ее в SQL Server.
Перед вызовом функции bcp_sendrow необходимо вызвать функцию bcp_bind, чтобы указать переменные программы, содержащие данные строки.
Если функция bcp_bind вызывается с указанием типа данных большого объема переменной длины, например параметра eDataType SQLTEXT и параметра pData, отличного от значения NULL, функция bcp_sendrow отправляет все данные значения, также как и для любого другого типа данных. Однако, если в функции bcp_bind параметр pData имеет значение NULL, функция bcp_sendrow возвращает управление приложению сразу после того, как все указанные столбцы с данными отправляются в SQL Server. Затем приложение может повторно вызывать функцию bcp_moretext, чтобы отправлять данные большого объема переменной длины в SQL Server по одному фрагменту данных за раз. Дополнительные сведения см. в разделе bcp_moretext.
Если функция bcp_sendrow используется для массового копирования строк из переменных программы в таблицы SQL Server, строки фиксируются только при вызове пользователем функции bcp_batch или bcp_done. Пользователь может вызывать функцию bcp_batch один раз для каждой из n строк или во время перерыва между периодами поступления данных. Если функция bcp_batch никогда не вызывается, то строки фиксируются при вызове функции bcp_done.
Сведения о важных изменениях в массовом копировании, реализованных в версии SQL Server 2005, см. в разделе Выполнение операций массового копирования (ODBC).