bcp_collen

Legt die Datenlänge in der Programmvariablen für die aktuelle Massenkopie in SQL Server fest.

Syntax

  
RETCODE bcp_collen (  
HDBC   
hdbc  
,  
DBINT   
cbData  
,  
INT   
idxServerCol  
);  
  

Argumente

hdbc
Das für den Massenkopiervorgang aktivierte ODBC-Verbindungshandle.

cbData-
Ist die Länge der Daten in der Programmvariable, nicht einschließlich der Länge eines Längenindikators oder Terminators. Wenn cbData auf SQL_NULL_DATA festgelegt wird, wird angegeben, dass alle zeilen, die auf den Server kopiert wurden, einen NULL-Wert für die Spalte enthalten. Wenn sie auf SQL_VARLEN_DATA festgelegt wird, wird angegeben, dass ein Zeichenfolgenterminator oder eine andere Methode verwendet wird, um die Länge der kopierten Daten zu bestimmen. Wenn sowohl ein Längenindikator als auch ein Terminator vorhanden sind, verwendet das System, je nachdem, was zu weniger Daten kopiert wird.

idxServerCol
Ist 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 gemeldet.

Rückkehr

SUCCEED oder FAIL.

Bemerkungen

Mit der funktion bcp_collen können Sie die Datenlänge in der Programmvariable für eine bestimmte Spalte ändern, wenn Sie Daten mit bcp_sendrow in SQL Server kopieren.

Zunächst wird die Datenlänge bestimmt, wenn bcp_bind aufgerufen wird. Wenn sich die Datenlänge zwischen Aufrufen von bcp_sendrow ändert und kein Längenpräfix oder Terminator verwendet wird, können Sie bcp_collen aufrufen, um die Länge zurückzusetzen. Der nächste Aufruf von bcp_sendrow verwendet die vom Aufruf festgelegte Länge, um bcp_collen.

Sie müssen bcp_collen einmal für jede Spalte in der Tabelle aufrufen, deren Datenlänge Sie ändern möchten.

Siehe auch

Massenkopierfunktionen