Allocation d’un handle d’environnement

La première tâche pour n’importe quelle application ODBC consiste à charger le Gestionnaire de pilotes ; la façon dont cela est effectué dépend du système d’exploitation. Par exemple, sur un ordinateur exécutant Microsoft Windows NT Server/Windows 2000 Server, Windows NT Workstation/Windows 2000 Professionnel ou Microsoft Windows 95/98, l’application est liée à la bibliothèque du Gestionnaire de pilotes ou appelle LoadLibrary pour charger la DLL du Gestionnaire de pilotes.

La tâche suivante, qui doit être effectuée avant qu’une application puisse appeler n’importe quelle autre fonction ODBC, consiste à initialiser l’environnement ODBC et à allouer un handle d’environnement, comme suit :

1. L’application déclare une variable de type SQLHENV. Il appelle ensuite SQLAllocHandle et transmet l’adresse de cette variable et l’option SQL_HANDLE_ENV. Par exemple:

   SQLHENV henv1;  
   
   SQLAllocHandle(SQL_HANDLE_ENV, SQL_NULL_HANDLE, &henv1);  
   

2. Le Gestionnaire de pilotes alloue une structure dans laquelle stocker des informations sur l’environnement et retourne le handle d’environnement dans la variable.

Le Gestionnaire de pilotes n’appelle pas SQLAllocHandle dans le pilote pour l’instant, car il ne sait pas quel pilote appeler. Il retarde l’appel de SQLAllocHandle dans le pilote jusqu’à ce que l’application appelle une fonction pour se connecter à une source de données. Pour plus d’informations, consultez le rôle du Gestionnaire de pilotes dans le processus de connexion, plus loin dans cette section.

Une fois l’application terminée à l’aide d’ODBC, elle libère le handle d’environnement avec SQLFreeHandle. Après avoir libéré l’environnement, utiliser le handle de l’environnement dans un appel à une fonction ODBC constitue une erreur de programmation d'application ; cela peut avoir des conséquences indéfinies mais probablement fatales.

Quand SQLFreeHandle est appelé, le pilote libère la structure utilisée pour stocker des informations sur l’environnement. Notez que SQLFreeHandle ne peut pas être appelé pour un handle d’environnement tant que tous les handles de connexion sur ce handle d’environnement n’ont pas été libérés.

Pour plus d’informations sur la gestion d’environnement, consultez Gestion des environnements.