bcp_collen

  • 發行項

設定目前大量複製到 SQL Server 之程式變數中的資料長度。

語法

RETCODE bcp_collen ( 
        HDBC hdbc, 
        DBINT cbData, 
        INT idxServerCol);

引數

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

  • cbData
    這是資料在程式變數中的長度，不包括任何長度指標或結束字元的長度。 將 cbData 設定為 SQL_NULL_DATA 表示複製到伺服器的所有資料列都包含適用於資料行的 NULL 值。 將它設定為 SQL_VARLEN_DATA 表示系統將會使用字串結束字元或其他方法來判斷已複製之資料的長度。 如果長度指標與結束字元同時存在，系統會使用造成複製的資料較少的那一個結果。

  • idxServerCol
    這是資料表中要將資料複製到其中之資料行的序數位置。 第一個資料行是 1。 資料行的序數位置是由 SQLColumns 所報告。

傳回值

SUCCEED 或 FAIL。

備註

bcp_collen 函數可讓您在使用 bcp_sendrow 將資料複製到 SQL Server 時，針對特定資料行變更程式變數中的資料長度。

一開始會在呼叫 bcp_bind 時判斷資料長度。 如果兩個 bcp_sendrow 呼叫之間的資料長度有所變更，而且未使用任何長度前置詞或結束字元，您可以呼叫 bcp_collen 來重設長度。 下一次呼叫 bcp_sendrow 時會使用 bcp_collen 呼叫所設定的長度。

您必須針對您想要修改資料長度之資料表中的每一個資料行呼叫 bcp_collen 一次。

請參閱

參考

大量複製函數