'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).