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_bind，bcp_sendrow 會傳送整個資料值，就像是其他任何資料類型一樣。但是，如果 bcp_bind 具有 NULL pData 參數，bcp_sendrow 會在所有已指定資料的資料行傳送給 SQL Server 之後，立即將控制權傳給應用程式。然後應用程式可以重複呼叫 bcp_moretext，將長的變動長度資料傳送給 SQL Server (一次一個區塊)。如需詳細資訊，請參閱＜bcp_moretext＞。
當使用 bcp_sendrow 將程式變數中的資料列大量複製到 SQL Server 資料表時，只有當使用者呼叫 bcp_batch 或 bcp_done 時，才會認可資料列。使用者可以選擇在每隔 n 個資料列或是當內送資料的期間有暫停情況發生時，呼叫 bcp_batch。如果從未呼叫過 bcp_batch，則會在呼叫 bcp_done 時認可資料列。
如需有關從 SQL Server 2005 開始，大量複製重大變更的詳細資訊，請參閱＜執行大量複製作業 (ODBC)＞。