Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Observação
A nota técnica a seguir não foi atualizada desde que foi incluída pela primeira vez na documentação on-line. Como resultado, alguns procedimentos e tópicos podem estar desatualizados ou incorretos. Para obter as informações mais recentes, recomenda-se que pesquise o tópico de interesse no índice de documentação online.
Os aplicativos que usam classes de banco de dados MFC precisarão de um programa de instalação que instale componentes ODBC. Eles também podem precisar de um programa de administração ODBC que recuperará informações sobre os drivers disponíveis, para especificar drivers padrão e configurar fontes de dados. Esta nota descreve o uso da API do instalador ODBC para escrever esses programas.
Escrevendo um programa de instalação ODBC
Uma aplicação de base de dados MFC requer o Gestor de Drivers ODBC (ODBC.DLL) e os drivers ODBC para aceder a fontes de dados. Muitos drivers ODBC também exigem DLLs adicionais de rede e comunicação. A maioria dos drivers ODBC vem com um programa de instalação que instalará os componentes ODBC necessários. Os desenvolvedores de aplicativos que usam classes de banco de dados MFC podem:
Confie nos programas de instalação específicos do driver para instalar componentes ODBC. Isso não exigirá mais trabalho por parte do desenvolvedor - você pode apenas redistribuir o programa de configuração do driver.
Como alternativa, você pode escrever seu próprio programa de instalação, que instalará o gerenciador de driver e o driver.
A API do instalador ODBC pode ser usada para escrever programas de instalação específicos do aplicativo. As funções na API do instalador são implementadas pela DLL do instalador ODBC — ODBCINST.DLL no Windows de 16 bits e ODBCCP32.DLL no Win32. Uma aplicação pode chamar SQLInstallODBC na DLL do instalador, que instalará o gestor de drivers ODBC, os drivers ODBC e os tradutores necessários. Em seguida, regista os drivers e tradutores instalados no ODBCINST.INI (ou o registo do sistema, no NT).
SQLInstallODBC requer o caminho completo para o ficheiro ODBC.INF, que contém a lista de drivers a serem instalados e descreve os ficheiros que compõem cada driver. Ele também contém informações semelhantes sobre o gerente de motorista e tradutores. ODBC. Os arquivos INF são normalmente fornecidos por desenvolvedores de drivers.
Um programa também pode instalar componentes ODBC individuais. Para instalar o Gestor de Drivers, um programa chama primeiro a SQLInstallDriverManager na DLL do instalador para obter o diretório de destino para o Gestor de Drivers. Este é geralmente o diretório no qual as DLLs do Windows residem. Em seguida, o programa usa as informações na seção [ODBC Driver Manager] do ODBC. INF para copiar o Gerenciador de Driver e arquivos relacionados do disco de instalação para este diretório. Para instalar um driver individual, um programa primeiro chama SQLInstallDriver na DLL do instalador para adicionar a especificação do driver ao ficheiro ODBCINST.INI (ou ao registro, no NT).
SQLInstallDriver retorna o diretório de destino do driver — geralmente o diretório no qual as DLLs do Windows residem. Em seguida, o programa utiliza as informações na secção do driver do ficheiro ODBC.INF para copiar a DLL do driver e os arquivos relacionados do disco de instalação para este diretório.
Para obter mais informações sobre ODBC. INF, ODBCINST. INI e usando a API do instalador, consulte ODBC SDK Programmer's Reference, Capítulo 19, Instalando o software ODBC.
Criando um administrador ODBC
Um aplicativo de banco de dados MFC pode configurar fontes de dados ODBC de uma das duas maneiras, da seguinte maneira:
Use o administrador ODBC (disponível como um programa ou como um item do painel de controle).
Crie seu próprio programa para configurar fontes de dados.
Um programa que configura fontes de dados faz chamadas de função para a DLL do instalador. A DLL do instalador chama uma DLL de configuração para configurar uma fonte de dados. Há uma DLL de configuração para cada driver; pode ser a própria DLL do driver ou uma DLL separada. A DLL de instalação solicita ao usuário informações de que o driver precisa se conectar à fonte de dados e ao tradutor padrão, se suportado. Em seguida, ele chama a DLL do instalador e as APIs do Windows para registrar essas informações no ODBC.INI (ou registo).
Para exibir uma caixa de diálogo com a qual um usuário pode adicionar, modificar e excluir fontes de dados, um programa chama SQLManageDataSources a DLL do instalador. Esta função é invocada quando a DLL do instalador é chamada a partir do Painel de Controlo. Para adicionar, modificar ou excluir uma fonte de dados, SQLManageDataSources chama ConfigDSN a DLL de instalação para o driver associado a essa fonte de dados. Para adicionar, modificar ou excluir fontes de dados diretamente, um programa chama SQLConfigDataSource a DLL do instalador. O programa passa o nome da fonte de dados e uma opção que especifica a ação a ser executada.
SQLConfigDataSource chama ConfigDSN na DLL de configuração e passa-lhe os argumentos de SQLConfigDataSource.
Para obter mais informações, consulte ODBC SDK Programmer's Reference, Capítulo 23, Setup DLL Function Reference, e Chapter 24, Installer DLL Function Reference.