bcp_colptr
Legt die Datenadresse der Programmvariablen für die aktuelle Kopie in SQL Server fest.
Syntax
RETCODE bcp_colptr (
HDBC hdbc,
LPCBYTE pData,
INT idxServerCol);
Argumente
hdbc
Ist das für das Massenkopieren aktivierte ODBC-Verbindungshandle.pData
Ist ein Zeiger auf die zu kopierenden Daten. Wenn der gebundene Datentyp ein Typ mit umfangreichen Werten ist (beispielsweise SQLTEXT oder SQLIMAGE), dann kann pData NULL sein. Ein pData-Zeiger mit dem Wert NULL gibt an, dass lange Datenwerte mithilfe von bcp_moretext in Ausschnitten an SQL Server gesendet werden.Wenn pData auf NULL festgelegt wird und die Spalte, die dem gebundenen Feld zugeordnet ist, keinen umfangreichen Datentyp enthält, dann schlägt bcp_colptr fehl.
Weitere Informationen zu Datentypen für umfangreiche Werte finden Sie unter bcp_bind..
idxServerCol
Enthält die Ordnungsposition der Spalte in der Datenbanktabelle, in die die Daten kopiert werden Die erste Spalte einer Tabelle ist die Spalte 1. Die Ordnungsposition einer Spalte wird von SQLColumns ausgegeben.
Rückgabewert
SUCCEED oder FAIL.
Hinweise
Mit der bcp_colptr-Funktion können Sie die Adresse der Quelldaten für eine bestimmte Spalte ändern, wenn Daten mit 'bcp_sendrow' in SQL Server kopiert werden.
Anfänglich wird der Zeiger auf Benutzerdaten durch einen Aufruf von bcp_bind festgelegt. Wenn sich die Datenadresse der Programmvariablen zwischen Aufrufen von bcp_sendrow ändert, können Sie den Zeiger mit einem Aufruf von bcp_colptr auf die Datenadresse zurücksetzen. Mit dem nächsten Aufruf von bcp_sendrow werden die Daten gesendet, die durch den Aufruf von bcp_colptr adressiert wurden.
Für jede Tabellenspalte, deren Datenadresse geändert werden soll, muss ein separater bcp_colptr-Aufruf angegeben werden.