bcp_colptr

Dotyczy:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Ustawia adres danych zmiennej programu dla bieżącej kopii w SQL Server.

Syntax

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

Arguments

hdbc
Czy obsługa połączenia ODBC z obsługą kopiowania zbiorczego.

pData
To wskaźnik do danych do kopiowania. Jeśli typ danych ograniczony jest typem dużej wartości (np. SQLTEXT lub SQLIMAGE), pData może być NULL. NULL pData oznacza, że długie wartości danych będą wysyłane do SQL Server w blokach za pomocą bcp_moretext.

Jeśli pData jest ustawione na NULL, a kolumna odpowiadająca polu przypisanemu nie jest dużym typem wartości, bcp_colptr nie działa.

Więcej informacji o typach o dużej wartości można znaleźć w bcp_bind.

idxServerCol
To pozycja porządkowa kolumny w tabeli bazy danych, do której kopiowane są dane. Pierwsza kolumna w tabeli to kolumna 1. Pozycja porządkowa kolumny jest podawana przez SQLColumns.

Zwroty

POWODZENIE lub NIEPOWODZENIE.

Remarks

Funkcja bcp_colptr pozwala zmienić adres danych źródłowych dla konkretnej kolumny podczas kopiowania danych do SQL Server z bcp_sendrow.

Początkowo wskaźnik do danych użytkownika jest ustawiany przez wywołanie bcp_bind. Jeśli adres danych zmiennej programowej zmieni się między wywołaniami do bcp_sendrow, możesz wywołać bcp_colptr , aby zresetować wskaźnik do danych. Następne połączenie do bcp_sendrow przesyła dane adresowane przez rozmowę do bcp_colptr.

Musi istnieć osobne wywołanie bcp_colptr dla każdej kolumny w tabeli, której adres danych chcesz zmodyfikować.

Treści powiązane

• Rozszerzenia sterowników SQL Server - funkcje kopiowania masowego