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呼叫,其數據位址是您想要修改的。