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 имеет параметр null pData, 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).