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 nonNULL, 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 один раз в каждой строке или когда между периодами входящих данных возникает смешение. Если bcp_batch никогда не вызывается, строки фиксируются при вызове bcp_done .

Сведения о критическом изменении массового копирования, начиная с SQL Server 2005, см. в разделе "Выполнение операций массового копирования( ODBC)".

См. также

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