'bcp_sendrow'
Sendet eine Zeile mit Daten aus Programmvariablen an SQL Server.
Syntax
RETCODE bcp_sendrow (
HDBC
hdbc
);
Argumente
hdbc
Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.
Gibt zurück
SUCCEED oder FAIL.
Bemerkungen
Die funktion bcp_sendrow erstellt eine Zeile aus Programmvariablen und sendet sie an SQL Server.
Vor dem Aufruf von bcp_sendrowmü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. Wenn bcp_bind jedoch über einen pData-Parameter NULL verfügt, gibt bcp_sendrow die Steuerung unmittelbar nach dem Senden aller Spalten mit den angegebenen Daten an SQL Server an die Anwendung zurück. Die Anwendung kann dann bcp_moretext wiederholt aufrufen, um die langen Daten mit variabler Länge an SQL Server zu senden. Weitere Informationen finden Sie unter bcp_moretext.
Wenn bcp_sendrow zum Massenkopieren von Zeilen aus Programmvariablen in SQL Server Tabellen verwendet wird, werden Zeilen nur dann committet, 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 zu einer Breaking Change beim Massenkopiervorgang ab SQL Server 2005 finden Sie unter Ausführen von Massenkopiervorgängen (ODBC).