bcp_sendrow
S’applique à :
SQL Server Azure SQL Database Azure SQL Managed Instance Azure Synapse Analytics Analytics Platform System (PDW)
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 et de longueur variable, par exemple, un paramètre eDataType de SQLTEXT et un paramètre pData non NULL, 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 les données spécifiées sont 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 bloc à 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 (9.x), consultez Exécution d’opérations de copie en bloc (ODBC).