Partager via


bcp_sendrow

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

Syntaxe

RETCODE bcp_sendrow ( 
    HDBC hdbc);

Arguments

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

Valeurs retournées

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. Toutefois, si bcp_bind possède un paramètre pData NULL, bcp_sendrow redonne le contrôle à l'application immédiatement après que tous 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 de longueur variable à SQL Server, segment par segment. 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 toutes les nouvelles modifications majeures apportées à la copie en bloc dans SQL Server 2005, consultez Exécution d'opérations de copie en bloc (ODBC).

Voir aussi

Référence

Fonctions de copie en bloc