Share via


bcp_columns

SQL Server との一括コピー入出力に使用する、ユーザー ファイル内の合計列数を設定します。

構文

RETCODE bcp_columns (
        HDBC hdbc,
        INT nColumns);

引数

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

  • nColumns
    ユーザー ファイル内の合計列数です。ユーザー ファイルから SQL Server テーブルへのデータの一括コピーを準備していて、ユーザー ファイル内のすべての列をコピーしない場合でも、nColumns にユーザー ファイル内の合計列数を設定する必要があります。

戻り値

SUCCEED または FAIL を返します。

説明

この関数は、有効なファイル名を指定して bcp_init を呼び出した後にのみ呼び出すことができます。

この関数を呼び出す必要があるのは、既定とは異なる形式のユーザー ファイルを使用する場合のみです。ユーザー ファイルの既定の形式の詳細については、「bcp_init」を参照してください。

bcp_columns を呼び出した後は、ユーザー ファイル内の列ごとに bcp_colfmt を呼び出し、独自のファイル形式を完全に定義する必要があります。

関連項目

参照