bcp_colptr
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 di valore di grandi dimensioni, bcp_colptr ha esito negativo.
Per altre informazioni sui tipi di 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.
Restituisce
SUCCEED o FAIL.
Commenti
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 vuole modificare.