bcp_collen
Legt die Datenlänge in der Programmvariable für das aktuelle Massenkopieren nach SQL Server fest.
Syntax
RETCODE bcp_collen (
HDBC hdbc,
DBINT cbData,
INT idxServerCol);
Argumente
hdbc
Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.cbData
Die Länge der Daten in der Programmvariable ohne die Länge eines Längenindikators oder Längenabschlusszeichens. Wenn Sie cbData auf SQL_NULL_DATA setzen, wird angegeben, dass alle zum Server kopierten Zeilen einen NULL-Wert für die Spalte enthalten. Wenn Sie es auf SQL_VARLEN_DATA setzen, geben Sie damit an, dass ein Zeichenfolgenabschlusszeichen oder eine andere Methode verwendet wird, um die Länge der kopierten Daten zu bestimmen. Wenn sowohl ein Längenindikator als auch ein Abschlusszeichen vorliegen, bestimmt das System, was verwendet werden soll, daran, bei welchem Vorgang weniger Daten kopiert werden.idxServerCol
Die Ordnungsposition der Spalte in der Tabelle, in die die Daten kopiert werden. Die erste Spalte ist 1. Die Ordnungsposition einer Spalte wird von SQLColumns ausgegeben.
Rückgabewert
SUCCEED oder FAIL.
Hinweise
Mit der bcp_collen-Funktion können Sie die Datenlänge in der Programmvariable für eine bestimmte Spalte ändern, wenn Sie Daten mit bcp_sendrow nach SQL Server kopieren.
Anfänglich wird die Datenlänge beim Aufrufen von bcp_bind bestimmt. Wenn sich die Datenlänge zwischen den Aufrufen von bcp_sendrow ändert und kein Längenpräfix oder -abschlusszeichen verwendet wird, können Sie bcp_collen aufrufen, um die Länge zurückzusetzen. Mit dem nächsten Aufruf von bcp_sendrow wird der Längensatz vom Aufruf von bcp_collen verwendet.
Für jede Spalte in der Tabelle, deren Datenlänge Sie ändern möchten, muss bcp_collen einmal aufgerufen werden.