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 и отличного от типа NULL параметра pData, функция 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).