bcp_sendrow
Invia una riga di dati dalle variabili di programma a SQL Server.
Sintassi
RETCODE bcp_sendrow (
HDBC hdbc);
Argomenti
- hdbc
Handle di connessione ODBC abilitato per la copia bulk.
Valori restituiti
SUCCEED o FAIL.
Osservazioni
La funzione bcp_sendrow genera una riga dalle variabili di programma e la invia a SQL Server.
Prima di chiamare bcp_sendrow, è necessario effettuare chiamate a bcp_bind per specificare le variabili di programma che contengono i dati della riga.
Se bcp_bind viene chiamato specificando un tipo di dati Long a lunghezza variabile, ad esempio un parametro eDataType di SQLTEXT e un parametro pData nonNULL, bcp_sendrow invia il valore entiredata come per qualsiasi altro tipo di dati. Se tuttavia per bcp_bind si specifica un parametro pData NULL, bcp_sendrow restituisce immediatamente il controllo all'applicazione dopo avere inviato tutte le colonne con i dati specificati a SQL Server. L'applicazione può quindi chiamare bcp_moretext ripetutamente per inviare i dati Long a lunghezza variabile a SQL Server un blocco alla volta. Per ulteriori informazioni, vedere bcp_moretext.
Quando bcp_sendrow viene utilizzato per eseguire la copia bulk delle righe dalle variabili di programma alle tabelle di SQL Server, il commit delle righe viene eseguito solo se l'utente chiama bcp_batch o bcp_done. L'utente può scegliere di chiamare bcp_batch una volta ogni n righe o quando c'è una pausa nei dati in entrata. Se bcp_batch non viene mai chiamato, il commit delle righe viene eseguito quando viene chiamato bcp_done.
Per informazioni su una modifica di rilievo apportata alla funzione di copia bulk a partire da SQL Server 2005, vedere Esecuzione di operazioni di copia bulk (ODBC).