SQL Server への現在の一括コピーのプログラム変数のデータ長を設定します。
構文
RETCODE bcp_collen (
HDBC
hdbc
,
DBINT
cbData
,
INT
idxServerCol
);
論争
hdbc
一括コピーが有効な ODBC 接続ハンドルです。
cbData の
プログラム変数内のデータの長さであり、長さ標識またはターミネータの長さは含まれません。
cbData を SQL_NULL_DATA に設定すると、サーバーにコピーされたすべての行に列の NULL 値が含まれていることが示されます。 SQL_VARLEN_DATAに設定すると、文字列ターミネータまたはその他のメソッドを使用して、コピーされるデータの長さが決定されます。 長さ標識とターミネータの両方が存在する場合、システムはどちらか一方を使用すると、コピーされるデータが少なくなります。
idxServerCol
データのコピー先となるテーブル内の列の序数位置を指定します。 最初の列は 1 です。 列の序数位置は、 SQLColumns によって報告されます。
返品ポリシー
SUCCEED または FAIL。
注釈
bcp_collen関数を使用すると、bcp_sendrowを使用して SQL Server にデータをコピーするときに、特定の列のプログラム変数のデータ長を変更できます。
最初に、データの長さは 、bcp_bind が呼び出されたときに決定されます。 bcp_sendrowの呼び出しの間でデータ長が変化し、長さのプレフィックスまたはターミネータが使用されていない場合は、bcp_collenを呼び出して長さをリセットできます。 bcp_sendrowの次の呼び出しでは、bcp_collenの呼び出しによって設定された長さが使用されます。
データの長さを変更するテーブル内の列ごとに 、bcp_collen を 1 回呼び出す必要があります。