bcp_sendrow

適用於：SQL Server Azure SQL 資料庫 Azure SQL 受控執行個體 Azure Synapse Analytics Analytics Platform System （PDW）

將數據列從程式變數傳送至 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 參數和非 NULL 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時認可數據列。

如需從 SQL Server 2005 （9.x） 開始大量複製重大變更的相關信息，請參閱 執行大量複製作業 （ODBC） 。

另請參閱

大量複製函式