TN048: Escribir programas de instalación y administración de ODBC para aplicaciones de base de datos MFC
Nota:
La nota técnica siguiente no se ha actualizado desde que se incluyó por primera vez en la documentación en línea. Como resultado, algunos procedimientos y temas podrían estar obsoletos o ser incorrectos. Para obtener información más reciente, se recomienda buscar el tema de interés en el índice de la documentación en línea.
Las aplicaciones que usan clases de base de datos MFC necesitarán un programa de instalación que instale los componentes ODBC. También puede que necesiten un programa de administración de ODBC que recupere información sobre los controladores disponibles para especificar los controladores predeterminados y configurar los orígenes de datos. En esta nota se describe el uso de la API del instalador de ODBC para escribir estos programas.
Escritura de un programa de instalación de ODBC
Una aplicación de base de datos MFC requiere el Administrador de controladores ODBC (ODBC.DLL) y los controladores ODBC para poder acceder a orígenes de datos. Muchos controladores ODBC también requieren archivos DLL de red y comunicación adicionales. La mayoría de los controladores ODBC se incluyen con un programa de instalación que instalará los componentes ODBC necesarios. Los desarrolladores de aplicaciones que usan clases de base de datos MFC pueden:
Confiar en los programas de instalación específicos del controlador para instalar componentes ODBC. Esto no requerirá más trabajo por parte del desarrollador; simplemente puede redistribuir el programa de instalación del controlador.
Como alternativa, puede escribir su propio programa de instalación, el cual instalará el administrador de controladores y el controlador.
La API del instalador de ODBC se puede usar para escribir programas de instalación específicos de la aplicación. Las funciones de la API del instalador se implementan mediante el archivo DLL del instalador ODBC: ODBCINST.DLL en Windows de 16 bits y ODBCCP32.DLL en Win32. Una aplicación puede llamar a SQLInstallODBC en el archivo DLL del instalador y este instalará el administrador de controladores ODBC, los controladores ODBC y los traductores necesarios. A continuación, registra los controladores y traductores instalados en el archivo ODBCINST.INI (o en el registro, en NT). SQLInstallODBC requiere la ruta de acceso completa al archivo ODBC.INF que contiene la lista de controladores que se van a instalar y describe los archivos que componen cada controlador. También contiene información similar sobre el administrador de controladores y los traductores. Los desarrolladores de controladores proporcionan normalmente los archivos ODBC.INF.
Un programa también puede instalar componentes ODBC individuales. Para instalar el administrador de controladores, un programa llama a SQLInstallDriverManager primero en el archivo DLL del instalador para obtener el directorio de destino del administrador de controladores. Suele ser el directorio en el que residen los archivos DLL de Windows. A continuación, el programa usa la información de la sección [Administrador de controladores ODBC] del archivo ODBC.INF para copiar el administrador de controladores y los archivos relacionados del disco de instalación en este directorio. Para instalar un controlador individual, un programa llama a SQLInstallDriver primero en el archivo DLL del instalador para agregar la especificación del controlador al archivo ODBCINST.INI (o al registro, en NT). SQLInstallDriver devuelve el directorio de destino del controlador, normalmente el directorio en el que residen los archivos DLL de Windows. A continuación, el programa usa la información de la sección de controladores del archivo ODBC.INF para copiar el archivo DLL de controladores y los archivos relacionados del disco de instalación en este directorio.
Para más información sobre ODBC.INF, ODBCINST.INI y el uso de la API del instalador, consulte Referencia del programador del SDK de ODBC, capítulo 19, Instalación de software de ODBC.
Escritura de un administrador de ODBC
Una aplicación de base de datos MFC puede configurar orígenes de datos ODBC de dos maneras, como se indica a continuación:
Use el administrador de ODBC (disponible como programa o como elemento del panel de control).
Cree su propio programa para configurar orígenes de datos.
Un programa que configura orígenes de datos realiza llamadas de función al archivo DLL del instalador. El archivo DLL del instalador llama a un archivo DLL de instalación para configurar un origen de datos. Hay un archivo DLL de configuración para cada controlador; puede ser el propio archivo DLL del controlador o uno independiente. El archivo DLL de configuración solicita al usuario la información que el controlador necesita para conectarse al origen de datos y al traductor predeterminado, si se admite. A continuación, llama al archivo DLL del instalador y a las API de Windows para registrar esta información en el archivo ODBC.INI (o el registro).
Para mostrar un cuadro de diálogo con el que un usuario pueda agregar, modificar y eliminar orígenes de datos, un programa llama SQLManageDataSources en el archivo DLL del instalador. Esta función se invoca cuando se llama al archivo DLL del instalador desde el panel de control. Para agregar, modificar o eliminar un origen de datos, SQLManageDataSources llama a ConfigDSN en el archivo DLL de instalación del controlador asociado a ese origen de datos. Para agregar, modificar o eliminar orígenes de datos directamente, un programa llama a SQLConfigDataSource en el archivo DLL del instalador. El programa pasa el nombre del origen de datos y una opción que especifica la acción que se va a realizar. SQLConfigDataSource llama a ConfigDSN en el archivo DLL de instalación y le pasa los argumentos de SQLConfigDataSource.
Para más información, consulte Referencia del programador del SDK de ODBC, capítulo 23, Referencia de la función DLL de instalación y capítulo 24, Referencia de la función DLL del instalador.