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） 。