bcp_sendrow
將資料列從程式變數傳送至SQL Server。
語法
RETCODE bcp_sendrow (
HDBC
hdbc
);
引數
hdbc
這是已啟用大量複製的 ODBC 連接控制代碼。
傳回
SUCCEED 或 FAIL。
備註
bcp_sendrow函式會從程式變數建置資料列，並將它傳送至SQL Server。
呼叫 bcp_sendrow之前，您必須呼叫 bcp_bind ，以指定包含資料列資料的程式變數。
如果 呼叫 bcp_bind 指定 long、variable-length 資料類型，例如 SQLTEXT 的 eDataType 參數和 nonNull pData 參數， 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 時認可資料列。
如需從 2005 SQL Server 2005 開始大量複製重大變更的相關資訊，請參閱 (ODBC) 執行大量複製作業。