Fonctionnalités en doublon
Les fonctions ODBC 2.x suivantes ont été dupliquées par les fonctions ODBC 3.x . Par conséquent, les fonctions ODBC 2.x sont déconseillées dans ODBC 3.x. Les fonctions ODBC 3.x sont appelées fonctions de remplacement.
Lorsqu’une application utilise une fonction ODBC 2.x déconseillée et que le pilote sous-jacent est un pilote ODBC 3.x , le Gestionnaire de pilotes mappe l’appel de fonction à la fonction de remplacement correspondante. La seule exception à cette règle est SQLExtendedFetch. (Consultez la note de bas de page à la fin du tableau suivant.) Pour plus d’informations sur ces mappages, consultez Fonctions déconseillées dans l’annexe G : Instructions relatives à la compatibilité descendante.
Lorsqu’une application utilise une fonction de remplacement et que le pilote sous-jacent est un pilote ODBC 2.x , le Gestionnaire de pilotes mappe l’appel de fonction à la fonction déconseillée correspondante.
| Fonction ODBC 2.x | Fonction ODBC 3.x |
|---|---|
| SQLAlloc Connecter | SQLAllocHandle |
| SQLAllocEnv | SQLAllocHandle |
| SQLAllocStmt | SQLAllocHandle |
| SQLColAttributes | SQLColAttribute |
| Sqlerror | SQLGetDiagRec |
| SQLExtendedFetch[1] | SQLFetchScroll |
| SQLFree Connecter | SQLFreeHandle |
| SQLFreeEnv | SQLFreeHandle |
| SQLGet Connecter Option | SQLGetConnectAttr |
| SQLGetStmtOption | SQLGetStmtAttr |
| SQLParamOptions | SQLSetStmtAttr, SQLGetStmtAttr |
| SQLSet Connecter Option | SQLSetConnectAttr |
| SQLSetParam | SQLBindParameter |
| SQLSetStmtOption | SQLSetStmtAttr |
| SQLTransact | SQLEndTran |
[1] La fonction SQLExtendedFetch est une fonctionnalité dupliquée ; SQLFetchScroll fournit les mêmes fonctionnalités dans ODBC 3.x. Toutefois, le Gestionnaire de pilotes ne mappe pas SQLExtendedFetch à SQLFetchScroll lors de l’accès à un pilote ODBC 3.x . Pour plus d’informations, consultez Ce que fait le Gestionnaire de pilotes dans l’annexe G : Instructions relatives à la compatibilité descendante. Le Gestionnaire de pilotes mappe SQLFetchScroll à SQLExtendedFetch lors de l’accès à un pilote ODBC 2.x .
Remarque
La fonction SQLBindParam est un cas spécial. SQLBindParam est une fonctionnalité dupliquée. Il ne s’agit pas d’une fonction ODBC 2.x , mais d’une fonction présente dans les normes Open Group et ISO. La fonctionnalité fournie par cette fonction est entièrement sous-énumérée par celle de SQLBindParameter. Par conséquent, le Gestionnaire de pilotes mappe un appel à SQLBindParam à SQLBindParameter lorsque le pilote sous-jacent est un pilote ODBC 3.x . Toutefois, lorsque le pilote sous-jacent est un pilote ODBC 2.x , le Gestionnaire de pilotes n’effectue pas ce mappage.