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 das Massenkopieren 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.

Siehe auch

Verweis

Massenkopierfunktionen