Partager via


SQLRowCount

Lorsque des tableaux de valeurs de paramètre sont liés pour l’exécution d’instructions, SQLRowCount retourne SQL_ERROR si une ligne de valeurs de paramètre génère une condition d’erreur dans l’exécution de l’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ée à l’aide de l’attribut d’instruction SQL_ATTR_PARAM_STATUS_PTR, pour capturer les décalages de tableau des lignes de paramètres incriminées. L’application peut parcourir le tableau d’état pour déterminer le nombre réel de lignes traitées.

Lorsqu’une Transact-SQL instruction 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és par la clause OUTPUT n’ont pas été consommées. Pour énumérer ces lignes, vous appelez SQLFetch ou SQLFetchScroll. SQLResultCols retourne -1 jusqu’à ce que toutes les lignes de résultat aient été consommées. Une fois QUE SQLFetch ou SQLFetchScroll retourne SQL_NO_DATA, l’application doit appeler SQLRowCount pour déterminer le nombre de lignes affectées avant d’appeler SQLMoreResults pour passer au résultat suivant.

Voir aussi

SQLRowCount, fonction
Détails de l’implémentation d’API ODBC