bcp_colptr
Imposta l'indirizzo dei dati della variabile di programma per la copia corrente su 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 è un tipo di dati per valori di grandi dimensioni, ad esempio SQLTEXT o SQLIMAGE, pData può essere Null. Un valore Null per pData indica che i valori dei dati long verranno inviati a SQL Server in blocchi mediante bcp_moretext.Se pData è impostato su Null e la colonna che corrisponde al campo associato non è un tipo di dati per valori di grandi dimensioni, bcp_colptr avrà esito negativo.
Per ulteriori informazioni sui tipi di dati per valori 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 indicata da SQLColumns.
Restituisce
SUCCEED o FAIL.
Osservazioni
La funzione bcp_colptr consente di modificare l'indirizzo dei dati di origine per una determinata colonna in caso di copia di dati in SQL Server con bcp_sendrow.
Inizialmente, il puntatore ai dati dell'utente viene impostato da una chiamata a bcp_bind. Se l'indirizzo dei dati della variabile di programma cambia tra una chiamata e l'altra a bcp_sendrow, è possibile chiamare bcp_colptr per reimpostare il puntatore sui dati. La chiamata successiva a bcp_sendrow invia i dati indirizzati dalla chiamata a bcp_colptr.
È necessario eseguire una chiamata bcp_colptr separata per ogni colonna della tabella di cui si desidera modificare l'indirizzo dei dati.