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ückkehr

SUCCEED oder FAIL.

Bemerkungen

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

Bevor Sie bcp_sendrow aufrufen, müssen Sie Aufrufe an bcp_bind ausführen, um die Programmvariablen anzugeben, die Zeilendaten enthalten.

Wenn bcp_bind aufgerufen wird, um einen Datentyp mit langer Variabler Länge anzugeben, z. B. einen eDataType-Parameter von SQLTEXT und einen nichtNULL pData-Parameter , sendet bcp_sendrow den gesamten Datenwert genauso wie für jeden anderen Datentyp. Wenn bcp_bind jedoch über einen NULL-pData-Parameter verfügt, gibt bcp_sendrow die Steuerung unmittelbar nach dem Senden aller Spalten mit angegebenen Daten an SQL Server 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 Massenkopien von Zeilen aus Programmvariablen in SQL Server-Tabellen verwendet wird, werden Zeilen nur übernommen, wenn der Benutzer bcp_batch oder bcp_done aufruft. Der Benutzer kann sich entscheiden, bcp_batch einmal alle n Zeilen aufzurufen oder wenn zwischen Zeiträumen eingehender Daten eine Ull vorhanden ist. Wenn bcp_batch nie aufgerufen wird, werden die Zeilen beim Aufrufen bcp_done zugesichert.

Informationen zu einer bedeutenden Änderung des Massenkopiervorgangs ab SQL Server 2005 finden Sie unter Ausführen von Massenkopievorgängen (ODBC).

Siehe auch

Massenkopierfunktionen