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).