TN048 : écriture de programmes d'installation et d'administration ODBC pour les applications de base de données MFC
Remarque
La note technique suivante n'a pas été mise à jour depuis son inclusion initiale dans la documentation en ligne. Par conséquent, certaines procédures et rubriques peuvent être obsolètes ou incorrectes. Pour obtenir les informations les plus récentes, il est recommandé de rechercher l'objet qui vous intéresse dans l'index de la documentation en ligne.
Les applications utilisant des classes de base de données MFC ont besoin d’un programme d’installation qui installe des composants ODBC. Ils peuvent également avoir besoin d’un programme d’Administration istration 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 note décrit l’utilisation de l’API du programme d’installation ODBC pour écrire ces programmes.
Écriture d’un programme d’installation ODBC
Une application de base de données MFC nécessite le Gestionnaire de pilotes ODBC (ODBC.DLL) et les pilotes ODBC pour pouvoir accéder aux sources de données. De nombreux pilotes ODBC nécessitent également des DLL de réseau et de communication supplémentaires. La plupart des pilotes ODBC sont fournis avec un programme d’installation qui installe les composants ODBC requis. Les développeurs d’applications utilisant des classes de base de données MFC peuvent :
Reposez sur les programmes d’installation spécifiques au pilote pour l’installation des composants ODBC. Cela ne nécessite aucun travail supplémentaire sur la partie du développeur. Vous pouvez simplement redistribuer le programme d’installation du pilote.
Vous pouvez également écrire votre propre programme d’installation, qui installe le gestionnaire de pilotes et le pilote.
L’API du programme d’installation ODBC peut être utilisée pour écrire des programmes d’installation spécifiques à l’application. Les fonctions de l’API du 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
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 ODBCINST. Fichier INI (ou le Registre, sur NT). SQLInstallODBC
nécessite le chemin d’accès complet à ODBC. Fichier 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 de pilotes et les traducteurs. ODBC. Les fichiers INF sont généralement fournis par les développeurs de pilotes.
Un programme peut également installer des composants ODBC individuels. Pour installer le Gestionnaire de pilotes, un programme appelle SQLInstallDriverManager
d’abord la DLL du programme d’installation pour obtenir le répertoire cible du Gestionnaire de pilotes. Il s’agit généralement du répertoire dans lequel résident les DLL Windows. Le programme utilise ensuite les informations de la section [Gestionnaire de pilotes ODBC] de ODBC. Fichier INF pour copier le Gestionnaire de pilotes et les fichiers associés du disque d’installation vers ce répertoire. Pour installer un pilote individuel, un programme appelle SQLInstallDriver
d’abord la DLL du programme d’installation pour ajouter la spécification du pilote à ODBCINST. Fichier INI (ou le Registre, sur NT). SQLInstallDriver
retourne le répertoire cible du pilote , généralement le répertoire dans lequel résident les DLL Windows. Le programme utilise ensuite les informations dans la section du pilote du ODBC. Fichier INF pour copier la DLL du pilote et les fichiers associés du disque d’installation dans ce répertoire.
Pour plus d’informations sur ODBC. INF, ODBCINST. INI et à l’aide de l’API du programme d’installation, consultez la référence du programmeur du SDK ODBC, chapitre 19, installation de logiciels ODBC.
Écriture d’un Administration istrateur ODBC
Une application de base de données MFC peut configurer et configurer des sources de données ODBC de l’une des deux manières suivantes :
Utilisez l’Administration istrateur ODBC (disponible en tant que programme ou en tant qu’élément Panneau de configuration).
Créez votre propre programme pour configurer des sources de données.
Programme qui configure les 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 ; il peut s’agir de la DLL du pilote elle-même ou d’une DLL distincte. La DLL d’installation invite l’utilisateur à entrer des informations que le pilote doit se connecter à la source de données et au traducteur par défaut, s’il est pris en charge. Il appelle ensuite la DLL du programme d’installation et les API Windows pour enregistrer ces informations dans ODBC. Fichier INI (ou Registre).
Pour afficher une boîte de dialogue avec laquelle un utilisateur peut ajouter, modifier et supprimer des sources de données, un programme appelle SQLManageDataSources
dans la DLL du programme d’installation. Cette fonction est appelée lorsque la DLL du programme d’installation est appelée à partir de la Panneau de configuration. Pour ajouter, modifier ou supprimer une source de données, SQLManageDataSources
appelez ConfigDSN
la DLL d’installation pour le pilote associé à cette source de données. Pour ajouter, modifier ou supprimer directement 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 une option qui spécifie l’action à entreprendre. SQLConfigDataSource
appelle ConfigDSN
la DLL d’installation et la transmet aux arguments de SQLConfigDataSource
.
Pour plus d’informations, consultez la référence du programmeur du SDK ODBC, le chapitre 23, la référence de la fonction DLL d’installation et le chapitre 24, informations de référence sur la fonction DLL du programme d’installation.