Condividi tramite


bcp_colptr

Si applica a: SQL Server Database SQL di Azure Istanza gestita di SQL di Azure Azure Synapse Analytics Piattaforma di strumenti analitici (PDW)

Imposta l'indirizzo dati della variabile di programma per la copia corrente in SQL Server.

Sintassi

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

Argomenti

hdbc
Handle di connessione ODBC abilitato per la copia bulk.

pData
Puntatore ai dati da copiare. Se il tipo di dati associato è di grandi dimensioni,ad esempio SQLTEXT o SQLIMAGE, pData può essere NULL. Un valore pData NULL indica che i valori di dati lunghi verranno inviati a SQL Server in blocchi usando bcp_moretext.

Se pData è impostato su NULL e la colonna corrispondente al campo associato non è un tipo valore di grandi dimensioni, bcp_colptr ha esito negativo.

Per altre informazioni sui tipi valore di grandi dimensioni, vedere bcp_bind.

idxServerCol
Posizione ordinale della colonna nella tabella di database in cui vengono copiati i dati. La prima colonna di una tabella è la colonna 1. La posizione ordinale di una colonna viene segnalata da SQLColumns.

Valori restituiti

SUCCEED o FAIL.

Osservazioni:

La funzione bcp_colptr consente di modificare l'indirizzo dei dati di origine per una determinata colonna durante la copia dei dati in SQL Server con bcp_sendrow.

Inizialmente, il puntatore ai dati utente viene impostato da una chiamata a bcp_bind. Se l'indirizzo dati della variabile di programma cambia tra le chiamate a bcp_sendrow, è possibile chiamare bcp_colptr per reimpostare il puntatore ai dati. La chiamata successiva a bcp_sendrow invia i dati indirizzati dalla chiamata a bcp_colptr.

Deve essere presente una chiamata bcp_colptr separata per ogni colonna della tabella il cui indirizzo dati si desidera modificare.

Vedi anche

Funzioni di copia bulk