bcp_sendrow

適用於：SQL ServerAzure SQL DatabaseAzure SQL 受控執行個體Azure Synapse AnalyticsAnalytics 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） 。

另請參閱

大量複製函式