bcp_colptr

gäller för:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse Analytics

Sätter programvariabelns dataadress för den aktuella kopian i SQL Server.

Syntax

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

Arguments

hdbc
Är den masskopieringsaktiverade ODBC-anslutningshandtaget.

pData (på engelska)
Är en pekare till datan att kopiera. Om den bundna datatypen är en stor värdetyp (såsom SQLTEXT eller SQLIMAGE) kan pData vara NULL. En NULL pData indikerar att långa datavärden kommer att skickas till SQL Server i chunkar med hjälp av bcp_moretext.

Om pData sätts till NULL och kolumnen som motsvarar det begränsade fältet inte är en stor värdetyp, misslyckas bcp_colptr .

För mer information om stora värdetyper, se bcp_bind.

idxServerCol
Är den ordinala positionen för kolumnen i databastabellen som datan kopieras till. Den första kolumnen i en tabell är kolumn 1. Kolumnens ordinala position rapporteras av SQLColumns.

Returns

SUCCEED eller FAIL.

Remarks

Funktionen bcp_colptr låter dig ändra adressen på källdata för en viss kolumn när du kopierar data till SQL Server med bcp_sendrow.

Inledningsvis sätts pekaren till användardata genom ett anrop till bcp_bind. Om programvariabelns dataadress ändras mellan anrop till bcp_sendrow kan du anropa bcp_colptr för att återställa pekaren till datan. Nästa samtal till bcp_sendrow skickar data adresserad av samtalet till bcp_colptr.

Det måste finnas ett separat bcp_colptr anrop för varje kolumn i tabellen vars dataadress du vill ändra.

Relaterat innehåll

• SQL Server drivrutinstillägg - Bulkkopieringsfunktioner