Résultats du processus (ODBC)

Pour traiter les résultats

1. Récupérer les informations du jeu de résultats.

2. Si des colonnes liées sont utilisées, pour chaque colonne à laquelle vous souhaitez effectuer une liaison, appelez SQLBindCol pour lier une mémoire tampon de programme à la colonne.

3. Pour chaque ligne du jeu de résultats :

   • Appelez SQLFetch pour obtenir la ligne suivante.

   • Si des colonnes liées sont utilisées, utilisez les données désormais disponibles dans les mémoires tampons de colonne liée.

   • Si des colonnes indépendantes sont utilisées, appelez SQLGetData une ou plusieurs fois pour obtenir les données des colonnes non liées après la dernière colonne liée. Les appels à doivent SQLGetData être de plus en plus dans l’ordre croissant du numéro de colonne.

   • Appelez SQLGetData plusieurs fois pour obtenir des données à partir d’une colonne de texte ou d’image.

4. Lorsque SQLFetch signale la fin du jeu de résultats en retournant SQL_NO_DATA, appelez SQLMoreResults pour déterminer si un autre jeu de résultats est disponible.

   • Si elle retourne SQL_SUCCESS, un autre jeu de résultats est disponible.

   • Si elle retourne SQL_NO_DATA, aucun autre jeu de résultats n’est disponible.

   • Si elle retourne SQL_SUCCESS_WITH_INFO ou SQL_ERROR, appelez SQLGetDiagRec pour déterminer si la sortie d’une instruction PRINT ou RAISERROR est disponible.

     Si les paramètres d’instruction liée sont utilisés pour les paramètres de sortie ou la valeur de retour d’une procédure stockée, utilisez les données désormais disponibles dans les mémoires tampons de paramètres liés. En outre, lorsque des paramètres liés sont utilisés, chaque appel à SQLExecute ou SQLExecDirect a exécuté les heures S de l’instruction SQL, où S est le nombre d’éléments dans le tableau de paramètres liés. Cela signifie qu’il y aura des ensembles de résultats S à traiter, où chaque ensemble de résultats comprend tous les jeux de résultats, les paramètres de sortie et les codes de retour généralement retournés par une seule exécution de l’instruction SQL.

   Remarque

   Lorsqu’un jeu de résultats contient des lignes de calcul, chaque ligne de calcul est rendue disponible en tant que jeu de résultats distinct. Ces jeux de résultats de calcul sont entrelacés dans les lignes normales et décomposent les lignes normales en plusieurs jeux de résultats.

5. Si vous le souhaitez, appelez SQLFreeStmt avec SQL_UNBIND pour libérer les mémoires tampons de colonnes liées.

6. Si un autre jeu de résultats est disponible, accédez à l’étape 1.

Voir aussi

Rubriques de procédure de traitement des résultats (ODBC)