bcp_colptr

Gilt für: SQL Server Azure SQL-Datenbank Azure SQL verwaltete Instanz Azure Synapse Analytics Analytics Platform System (PDW)

Legt die Programmvariablen-Datenadresse für die aktuelle Kopie in SQL Server fest.

Syntax

  
RETCODE bcp_colptr (  
        HDBC hdbc,  
        LPCBYTE pData,  
        INT idxServerCol);  

Argumente

hdbc
Das für den Massenkopiervorgang 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_moretextin 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
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 SQLColumnsausgegeben.

Gibt zurück

SUCCEED oder FAIL.

Hinweise

Mit der funktion bcp_colptr können Sie die Adresse der Quelldaten für eine bestimmte Spalte ändern, wenn Sie Daten mit bcp_sendrow in SQL Server kopieren.

Anfänglich wird der Zeiger auf Benutzerdaten durch einen Aufruf von bcp_bindfestgelegt. 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_colptradressiert wurden.

Für jede Tabellenspalte, deren Datenadresse geändert werden soll, muss ein separater bcp_colptr -Aufruf angegeben werden.

Weitere Informationen

Massenkopierfunktionen