Freigeben über


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.

Siehe auch

Verweis