TN048 : Programmes d'installation et de gestion ODBC d'écriture pour les applications de base de données MFC
[!REMARQUE]
La note technique suivante n'a pas été modifiée depuis si c'était première inclus dans la documentation en ligne.Par conséquent, certaines procédures et rubriques peuvent être obsolètes ou incorrects.Pour obtenir les informations les plus récentes, il est recommandé que vous trouviez la rubrique d'intérêt dans l'index de la documentation en ligne.
Les applications utilisant les classes MFC de base de données auront besoin d'un programme d'installation qui installe les composants ODBC.Ils peuvent également avoir besoin d'un programme d'administration ODBC qui récupère des informations sur les pilotes disponibles, pour spécifier les pilotes par défaut et configurer des sources de données.Cette remarque décrit l'utilisation de l'API de programme d'installation ODBC d'écrire ces programmes.
Écrire un programme d'installation ODBC
Une application de base de données MFC exige que le gestionnaire de pilotes ODBC (ODBC.DLL) et des pilotes ODBC pour pouvoir accéder aux sources de données.La plupart des pilotes ODBC nécessitent également des DLL supplémentaires de réseau et de communication.La plupart des pilotes ODBC sont fournies avec un programme d'installation qui installe les composants requis ODBC.Les développeurs d'applications à l'aide de classes de base de données MFC peuvent :
Appuyez sur les programmes d'installation de pilote-détail pour installer des composants ODBC.Cela ne requiert aucun autre travail de la partie du développeur — vous pouvez simplement redistribuer le programme d'installation du pilote.
Sinon, vous pouvez écrire votre propre programme d'installation, qui installe le gestionnaire de pilote et le pilote.
L'API de programme d'installation ODBC peut être utilisée pour écrire des programmes d'installation spécifiques à l'application.Les fonctions de l'API de programme d'installation sont implémentées par la DLL du programme d'installation ODBC — ODBCINST.DLL sur windows 16 bits et ODBCCP32.DLL sur Win32.Une application peut appeler SQLInstallODBC dans la DLL du programme d'installation, qui installe le gestionnaire de pilotes ODBC, les pilotes ODBC, et tous les traducteurs requis.Il enregistre ensuite les pilotes et les traducteurs installés dans le fichier d'ODBCINST.INI (ou le Registre, dans NT).SQLInstallODBC requiert le chemin d'accès complet au fichier d'ODBC.INF, qui contient la liste des pilotes à installer et décrit les fichiers qui composent chaque pilote.Il contient également des informations similaires sur le gestionnaire et les traducteurs de pilote.Les fichiers d'ODBC.INF sont généralement fournis par les développeurs de pilote.
Un programme peut également installer des composants ODBC.Pour installer le gestionnaire de pilote, premiers appels SQLInstallDriverManager d'un programme dans la DLL du programme d'installation pour obtenir le répertoire cible pour le gestionnaire de pilote.Il s'agit généralement du répertoire dans lequel les DLL de fenêtres résident.Le programme utilise ensuite les informations dans la section [gestionnaire de pilote ODBC] du fichier d'ODBC.INF pour copier le gestionnaire et les fichiers connexes de pilote du disque d'installation à ce répertoire.Pour installer un pilote individuel, premiers appels SQLInstallDriver d'un programme dans la DLL du programme d'installation pour ajouter la spécification de pilote au fichier d'ODBCINST.INI (ou dans le Registre, dans NT).SQLInstallDriver retourne le répertoire cible du pilote — généralement le répertoire dans lequel les DLL de fenêtres résident.Le programme utilise ensuite les informations dans la section du pilote du fichier d'ODBC.INF pour copier la DLL de pilote et les fichiers connexes à partir de le disque d'installation à ce répertoire.
Pour plus d'informations sur ODBC.INF, ODBCINST.INI et l'utilisation de l'API de programme d'installation, consultez le guide ODBC SDK Programmer's Reference , chapitre 19, l'installation du logiciel ODBC.
Écrire un Administrateur ODBC
Une application de base de données MFC peut installer et configurer les sources de données ODBC de deux manières différentes, comme suit :
Utilisez l'Administrateur ODBC (disponible comme programme ou élément du Panneau de configuration).
Créez votre propre programme de configurer les sources de données.
Un programme qui configure des sources de données effectue des appels de fonction à la DLL du programme d'installation.La DLL du programme d'installation appelle une DLL d'installation pour configurer une source de données.Il existe une DLL d'installation pour chaque pilote ; ce peut être la DLL de pilote lui-même, ou une DLL distincte.La DLL d'installation invite l'utilisateur à titre de information que le pilote doit connecter à la source de données et au traducteur par défaut, si pris en charge.Il appelle ensuite la DLL du programme d'installation et les API Windows pour stocker ces informations dans le fichier d'ODBC.INI (ou le Registre).
Pour afficher une boîte de dialogue à laquelle un utilisateur peut ajouter, modifier, supprimer et les sources de données, appelle SQLManageDataSources d'un programme dans la DLL du programme d'installation.Cette fonction est appelée lorsque la DLL du programme d'installation est appelé depuis le panneau de configuration.Pour ajouter, modifier, ou supprimer une source de données, SQLManageDataSources appelle ConfigDSN dans la DLL d'installation du pilote associé à cette source de données.Pour ajouter directement, modifier, ou supprimer des sources de données, un programme appelle SQLConfigDataSource dans la DLL du programme d'installation.Le programme passe le nom de la source de données et d'une option qui spécifie l'action à effectuer.SQLConfigDataSource appelle ConfigDSN dans la DLL d'installation et le passe les arguments de SQLConfigDataSource.
Pour plus d'informations, consultez le guide ODBC SDK Programmer's Reference , chapitre 23, la référence de fonction DLL d'installation, puis chapitre 24, référence de fonction DLL de programme d'installation.