Share via


bcp_batch

プログラム変数から既に一括コピーされており、bcp_sendrow によって SQL Server に送信されたすべての行をコミットします。

構文

DBINT bcp_batch (HDBC
        hdbc);

引数

  • hdbc
    一括コピーが有効な ODBC 接続ハンドルです。

戻り値

bcp_batch を最後に呼び出した後に保存された行数を返します。エラーが発生した場合は -1 を返します。

説明

一括コピーのバッチではトランザクションを定義します。アプリケーションで bcp_bindbcp_sendrow を使用して、プログラム変数から SQL Server テーブルに行を一括コピーすると、プログラムで bcp_batch または bcp_done を呼び出した場合のみ、行がコミットされます。

bcp_batch は、n 行ごとに 1 回呼び出すか、遠隔計測アプリケーションなどで、着信したデータに一時的な静止状態がある場合に呼び出すことができます。アプリケーションから bcp_batch を呼び出さないときは、bcp_done が呼び出された場合のみ、一括コピーされた行がコミットされます。

関連項目

参照