共用方式為


bcp_sendrow

將程式變數中的資料列傳送給 SQL Server。

語法

RETCODE bcp_sendrow (
    HDBC hdbc);

引數

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

傳回值

SUCCEED 或 FAIL。

備註

bcp_sendrow 函數會從程式變數建立資料列,並將它傳送給 SQL Server。

在呼叫 bcp_sendrow 之前,您必須進行 bcp_bind 的呼叫來指定包含資料列資料的程式變數。

如果指定長的變動長度資料類型 (例如 SQLTEXT 的 eDataType 參數及非 NULL pData 參數) 來呼叫 bcp_bindbcp_sendrow 會傳送整個資料值,就像是其他任何資料類型一樣。但是,如果 bcp_bind 具有 NULL pData 參數,bcp_sendrow 會在所有已指定資料的資料行傳送給 SQL Server 之後,立即將控制權傳給應用程式。然後應用程式可以重複呼叫 bcp_moretext,將長的變動長度資料傳送給 SQL Server (一次一個區塊)。如需詳細資訊,請參閱<bcp_moretext>。

當使用 bcp_sendrow 將程式變數中的資料列大量複製到 SQL Server 資料表時,只有當使用者呼叫 bcp_batchbcp_done 時,才會認可資料列。使用者可以選擇在每隔 n 個資料列或是當內送資料的期間有暫停情況發生時,呼叫 bcp_batch。如果從未呼叫過 bcp_batch,則會在呼叫 bcp_done 時認可資料列。

如需有關從 SQL Server 2005 開始,大量複製重大變更的詳細資訊,請參閱<執行大量複製作業 (ODBC)>。

請參閱

參考