bcp_colptr

van toepassing op:SQL ServerAzure SQL DatabaseAzure SQL Managed InstanceAzure Synapse AnalyticsAnalytics Platform System (PDW)

Stelt het data-adres van de programmavariabele in voor de huidige kopie in SQL Server.

Syntax

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

Arguments

hdbc-
Is de ODBC-verbindingshandgreep waarvoor bulksgewijs kopiƫren is ingeschakeld.

pData-
Is een verwijzing naar de data die gekopieerd moet worden. Als het gebonden datatype een groot waardetype is (zoals SQLTEXT of SQLIMAGE), kan pData NULL zijn. Een NULL pData geeft aan dat lange datawaarden in chunks naar SQL Server worden gestuurd met behulp van bcp_moretext.

Als pData op NULL is gezet en de kolom die bij het gebonden veld hoort geen groot waardetype is, faalt bcp_colptr .

Voor meer informatie over typen met grote waardes, zie bcp_bind.

idxServerCol
Is de ordinaalpositie van de kolom in de databasetabel waarnaar de gegevens worden gekopieerd. De eerste kolom in een tabel is kolom 1. De ordinaalpositie van een kolom wordt gerapporteerd door SQLColumns.

Returns

SLAGEN OF MISLUKKEN.

Remarks

De bcp_colptr-functie stelt je in staat het adres van brongegevens voor een bepaalde kolom te wijzigen wanneer je data naar SQL Server kopieert met bcp_sendrow.

Aanvankelijk wordt de verwijzing naar gebruikersgegevens ingesteld door een aanroep naar bcp_bind. Als het dataadres van de programmavariabele verandert tussen aanroepen naar bcp_sendrow, kun je bcp_colptr aanroepen om de pointer naar de data te resetten. De volgende oproep naar bcp_sendrow stuurt de gegevens die door het gesprek worden geadresseerd naar bcp_colptr.

Er moet een aparte bcp_colptr aanroep zijn voor elke kolom in de tabel waarvan je het data-adres wilt wijzigen.