bcp_collen
Imposta la lunghezza dei dati nella variabile di programma per la copia bulk corrente in SQL Server.
Sintassi
RETCODE bcp_collen (
HDBC hdbc,
DBINT cbData,
INT idxServerCol);
Argomenti
hdbc
Handle di connessione ODBC abilitato per la copia bulk.cbData
Lunghezza dei dati nella variabile di programma esclusa la lunghezza dei caratteri di terminazione o degli indicatori di lunghezza. L'impostazione di cbData su SQL_NULL_DATA indica che tutte le righe copiate nel server contengono un valore NULL per la colonna. L'impostazione di cbData su SQL_VARLEN_DATA indica che verrà utilizzato un carattere di terminazione della stringa o un altro metodo per determinare la lunghezza dei dati copiati. Se sono presenti sia un indicatore di lunghezza che un carattere di terminazione, il sistema utilizzerà il metodo che comporta la copia del minor numero di dati.idxServerCol
Posizione ordinale della colonna nella tabella in cui vengono copiati i dati. La prima colonna è 1. La posizione ordinale di una colonna viene indicata da SQLColumns.
Valori restituiti
SUCCEED o FAIL.
Osservazioni
La funzione bcp_collen consente di modificare la lunghezza dei dati nella variabile di programma per una determinata colonna durante la copia dei dati in SQL Server con bcp_sendrow.
La lunghezza dei dati viene determinata inizialmente quando viene chiamato bcp_bind. Se la lunghezza dei dati viene modificata tra le chiamate a bcp_sendrow e non viene utilizzato alcun prefisso di lunghezza o carattere di terminazione, è possibile chiamare bcp_collen per reimpostare la lunghezza. La chiamata successiva a bcp_sendrow utilizza la lunghezza impostata dalla chiamata a bcp_collen.
È necessario chiamare bcp_collen una volta per ogni colonna della tabella di cui si desidera modificare la lunghezza dei dati.