Partager via


bcp_sendrow

Envoie une ligne de données des variables de programme à SQL Server.

Syntaxe

  
RETCODE bcp_sendrow (  
    HDBC   
hdbc  
);  
  

Arguments

hdbc
Handle de connexion ODBC compatible avec la copie en bloc.

Retours

SUCCEED ou FAIL.

Notes

La fonction bcp_sendrow génère une ligne à partir de variables de programme et l’envoie à SQL Server.

Avant d'appeler bcp_sendrow, vous devez effectuer des appels à bcp_bind pour spécifier les variables de programme qui contiennent des données de ligne.

Si bcp_bind est appelé en spécifiant un type de données long de longueur variable (par exemple, un paramètre eDataType SQLTEXT et un paramètre pData nonNULL), bcp_sendrow envoie la valeur de données entière, comme pour tout autre type de données. Si, toutefois, bcp_bind a un paramètre pData NULL, bcp_sendrow retourne le contrôle à l’application immédiatement après que toutes les colonnes avec des données spécifiées ont été envoyées à SQL Server. L’application peut ensuite appeler bcp_moretext à plusieurs reprises pour envoyer les données longues et de longueur variable à SQL Server, un segment à la fois. Pour plus d'informations, consultez bcp_moretext.

Lorsque bcp_sendrow est utilisé pour copier en bloc des lignes à partir de variables de programme dans des tables SQL Server, les lignes sont validées uniquement lorsque l’utilisateur appelle bcp_batch ou bcp_done. L'utilisateur peut choisir d'appeler bcp_batch une fois chaque n lignes ou lors de creux entre deux périodes de données entrantes. Si bcp_batch n'est jamais appelé, les lignes sont validées lorsque bcp_done est appelé.

Pour plus d’informations sur une modification cassante de la copie en bloc à partir de SQL Server 2005, consultez Exécution d’opérations de copie en bloc (ODBC).

Voir aussi

Bulk Copy Functions