分享方式:


bcp_colptr

適用於:SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics 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呼叫,其數據位址是您想要修改的。

另請參閱

大量複製函式