bcp_colptr

將目前副本的程式變數資料位址設定成 SQL Server。

語法

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

引數

• hdbc
  這是已啟用大量複製的 ODBC 連接控制代碼。

• pData
  這是要複製之資料的指標。如果繫結資料類型是大數值類型 (例如 SQLTEXT 或 SQLIMAGE)，pData 就可以是 NULL。NULL pData 是表示 Long 資料值將以使用 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 呼叫。

請參閱

參考

大量複製函數