bcp_colptr

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.

Vedere anche

Riferimento