次の方法で共有

bcp_colptr

  • [アーティクル]

適用対象:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

現在のコピーのプログラム変数データ アドレスを SQL Server に設定します。

構文

  
RETCODE bcp_colptr (  
        HDBC hdbc,  
        LPCBYTE pData,  
        INT idxServerCol);

引数

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

pData
コピーするデータを指すポインターです。 バインドされたデータ型が大きな値型 (SQLTEXT や SQLIMAGE など) の場合、 pData は NULL にすることができます。 NULL pData は、長いデータ値が、bcp_moretextを使用してチャンクでSQL Serverに送信されることを示します。

pData が NULL に設定されていて、バインドされたフィールドに対応する列が大きな値型でない場合、bcp_colptrは失敗します。

大きな値の型の詳細については、「bcp_bind」を参照してください。

idxServerCol
データベース テーブル内にある、データのコピー先となる列の序数位置です。 テーブル内の最初の列は列 1 です。 列の序数位置は 、SQLColumns によって報告されます。

戻り値

SUCCEED または FAIL。

解説

bcp_colptr関数を使用すると、データを bcp_sendrow でSQL Serverにコピーするときに、特定の列のソース データのアドレスを変更できます。

最初に、ユーザー データへのポインターは、bcp_bindの呼び出しによって設定 されます。 プログラム変数データ・アドレスが bcp_sendrowへの呼び出しの間に変更された場合は、 bcp_colptr を呼び出してデータへのポインターをリセットできます。 bcp_sendrowへの次回の呼び出しでは、呼び出しによってアドレス指定されたデータが bcp_colptr に送信されます。

データ アドレスを変更するテーブル内のすべての列に対して、個別の bcp_colptr 呼び出しが必要です。

参照

一括コピー関数