Utiliser une requête (ODBC)

Pour utiliser une instruction

1. Appelez SQLAllocHandle avec un HandleType de SQL_HANDLE_STMT pour allouer un handle d’instruction.

2. Si vous le souhaitez, appelez SQLSetStmtAttr pour définir des options d’instruction ou SQLGetStmtAttr pour obtenir des attributs d’instruction.

   Pour utiliser des curseurs serveur, vous devez définir des attributs de curseur sur des valeurs autres que leurs valeurs par défaut.

3. Si vous le souhaitez, si l’instruction est exécutée plusieurs fois, préparez l’instruction pour l’exécution avec LA fonction SQLPrepare.

4. Si vous le souhaitez, si l’instruction a des marqueurs de paramètres liés, liez les marqueurs de paramètres aux variables de programme à l’aide de SQLBindParameter. Si l’instruction a été préparée, vous pouvez appeler SQLNumParams et SQLDescribeParam pour rechercher le nombre et les caractéristiques des paramètres.

5. Exécutez une instruction directement à l’aide de SQLExecDirect.

   ou

   Si l’instruction a été préparée, exécutez-la plusieurs fois à l’aide de SQLExecute.

   ou

   Appelez une fonction de catalogue, qui retourne les résultats.

6. Traitez les résultats en liant les colonnes du jeu de résultats aux variables de programme, en déplaçant les données des colonnes du jeu de résultats vers des variables de programme à l’aide de SQLGetData ou une combinaison des deux méthodes.

   Extraire dans le jeu de résultats d’une instruction une ligne à la fois.

   ou

   Extrayez au sein du jeu de résultats plusieurs lignes à la fois à l’aide d’un curseur de bloc.

   ou

   Appelez SQLRowCount pour déterminer le nombre de lignes affectées par une instruction INSERT, UPDATE ou DELETE.

   Si l’instruction SQL peut avoir plusieurs jeux de résultats, appelez SQLMoreResults à la fin de chaque jeu de résultats pour voir s’il existe des jeux de résultats supplémentaires à traiter.

7. Une fois les résultats traités, les actions suivantes peuvent être nécessaires pour rendre le handle d’instruction disponible pour exécuter une nouvelle instruction :

   • Si vous n’avez pas appelé SQLMoreResults tant qu’il n’a pas retourné SQL_NO_DATA, appelez SQLCloseCursor pour fermer le curseur.

   • Si vous avez lié des marqueurs de paramètres à des variables de programme, appelez SQLFreeStmt avec l’option définie sur SQL_RESET_PARAMS pour libérer les paramètres liés.

   • Si vous avez lié des colonnes de jeu de résultats à des variables de programme, appelez SQLFreeStmt avec l’option définie sur SQL_UNBIND pour libérer les colonnes liées.

   • Pour réutiliser le handle d’instruction, accédez à l’étape 2.

8. Appelez SQLFreeHandle avec un HandleType de SQL_HANDLE_STMT pour libérer le handle d’instruction.

Voir aussi

Exécution de rubriques de procédure sur les requêtes (ODBC)