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


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).

См. также

Справочник