Share via

bcp_colptr

  • 發行項

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure 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呼叫，其資料位址是您想要修改的。

另請參閱

大量複製函式