Partager via


SQLRowCount

Lorsque des tableaux de valeurs de paramètre sont liés pour l'exécution d'une instruction, SQLRowCount retourne SQL_ERROR si une ligne de valeurs de paramètre génère une condition d'erreur dans l'exécution d'une instruction. Aucune valeur n'est retournée via l'argument RowCountPtr de la fonction.

L'application peut tirer parti de l'attribut d'instruction SQL_ATTR_PARAMS_PROCESSED_PTR pour capturer le nombre de paramètres traités avant l'erreur.

En outre, l'application peut utiliser un tableau de valeurs d'état, lié via l'utilisation de l'attribut d'instruction SQL_ATTR_PARAM_STATUS_PTR, pour capturer les décalages des lignes de paramètres incriminées du tableau. L'application peut parcourir le tableau de valeurs d'état pour déterminer le nombre réel de lignes traitées.

Lorsqu'une instruction Transact-SQL INSERT, UPDATE, DELETE ou MERGE avec une clause OUTPUT est exécutée, SQLRowCount ne retourne pas le nombre de lignes affectées tant que toutes les lignes du jeu de résultats généré par la clause OUTPUT n'ont pas été consommées. Pour consommer ces lignes, vous devez appeler  SQLFetch ou SQLFetchScroll. SQLResultCols retourne -1 tant que toutes les lignes de résultat n'ont pas été consommées. Une fois que SQLFetch ou SQLFetchScroll a retourné SQL_NO_DATA, l'application doit appeler SQLRowCount afin de déterminer le nombre de lignes affectées avant d'appeler SQLMoreResults pour passer au résultat suivant.

Voir aussi

Concepts

Détails d'implémentation d'une API ODBC

Autres ressources

SQLRowCount (fonction)