'bcp_sendrow'

Sendet eine Datenzeile aus Programmvariablen an SQL Server. 

Syntax

RETCODE bcp_sendrow ( 
    HDBC hdbc);

Argumente

• hdbc
  Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.

Rückgabewert

SUCCEED oder FAIL.

Hinweise

Die bcp_sendrow-Funktion erstellt eine Zeile aus Programmvariablen und sendet sie an SQL Server.

Vor dem Aufruf von bcp_sendrow müssen Sie Aufrufe an bcp_bind vornehmen, um die Programmvariablen mit den Zeilendaten anzugeben.

Wird bcp_bind unter Angabe eines langen Datentyps variabler Länge wie einem eDataType-Parameter von SQLTEXT und einem pData-Parameter ungleich NULL aufgerufen, sendet bcp_sendrow wie bei jedem anderen Datentyp den gesamten Datenwert. Hat dagegen bcp_bind einen pData-Parameter mit NULL-Wert, gibt bcp_sendrow die Steuerung an die Anwendung zurück, sobald alle angegebenen Datenspalten an SQL Server gesendet wurden. Die Anwendung kann dann wiederholt bcp_moretext aufrufen, um die langen Daten variabler Länge Segment für Segment an SQL Server zu senden. Weitere Informationen finden Sie unter bcp_moretext.

Wenn mit bcp_sendrow Zeilen aus Programmvariablen in SQL Server-Tabellen massenkopiert werden, wird für die Zeilen erst dann ein Commit durchgeführt, wenn der Benutzer bcp_batch oder bcp_done aufruft. Der Benutzer kann bcp_batch wahlweise einmal für alle n Zeilen aufrufen oder dann, wenn bei den eingehenden Daten eine Pause auftritt. Wird bcp_batch nie aufgerufen, wird ein Commit für die Zeilen ausgeführt, wenn bcp_done aufgerufen wird.

Informationen über eine wichtige Änderung zum Massenkopieren ab SQL Server 2005 finden Sie unter Durchführen von Massenkopiervorgängen (ODBC).

Siehe auch

Verweis

Massenkopierfunktionen