Função SQLInstallDriverManager

Conformidade
Versão introduzida: ODBC 1.0: preterido no Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 e sistemas operacionais posteriores

Resumo
SQLInstallDriverManager retorna o caminho do diretório de destino para a instalação dos componentes principais do ODBC. O programa de chamada deve realmente copiar os arquivos do Gerenciador de Driver para o diretório de destino.

Sintaxe

  
BOOL SQLInstallDriverManager(  
     LPSTR    lpszPath,  
     WORD     cbPathMax,  
     WORD *   pcbPathOut);  

Argumentos

lpszPath
[Saída] Caminho do diretório de destino da instalação.

cbPathMax
[Entrada] Comprimento de lpszPath. Deve ser pelo menos _MAX_PATH bytes.

pcbPathOut
[Saída] Número total de bytes (excluindo o byte de terminação nula) retornado em lpszPath. Se o número de bytes disponíveis para retornar for maior ou igual a cbPathMax, o caminho em lpszPath será truncado para cbPathMax menos o caractere de terminação nula. O argumento pcbPathOut pode ser um ponteiro nulo.

Retornos

A função retornará TRUE se for bem-sucedida, FALSE se falhar.

Diagnósticos

Quando SQLInstallDriverManager retorna FALSE, um valor *pfErrorCode associado pode ser obtido chamando SQLInstallerError. A tabela a seguir lista os valores *pfErrorCode que podem ser retornados por SQLInstallerError e explica cada um deles no contexto dessa função.

*pfErrorCode	Erro	Descrição
ODBC_ERROR_GENERAL_ERR	Erro geral do instalador	Ocorreu um erro para o qual não houve nenhum erro específico do instalador.
ODBC_ERROR_INVALID_BUFF_LEN	Comprimento do buffer inválido	O argumento lpszPath não era grande o suficiente para conter o caminho de saída. O buffer contém o caminho truncado. O argumento cbPathMax foi menor que _MAX_PATH.
ODBC_ERROR_USAGE_UPDATE_FAILED	Não foi possível incrementar ou diminuir a contagem de uso do componente	O instalador falhou ao incrementar a contagem de uso do componente principal ODBC.
ODBC_ERROR_OUT_OF_MEM	Memória insuficiente	O instalador não pôde executar a função devido à falta de memória.

Comentários

SQLInstallDriverManager é chamado para retornar o caminho para componentes principais ODBC e incrementar a contagem de uso do componente nas informações do sistema. Se uma versão do Gerenciador de Driver já existir, mas a contagem de uso do componente para o driver não existir, o novo valor de contagem de uso do componente será definido como 2.

O programa de instalação do aplicativo é responsável por copiar fisicamente os arquivos principais do componente e manter as contagens de uso do arquivo. Se um arquivo de componente principal não tiver sido instalado anteriormente, o programa de instalação do aplicativo deverá copiar o arquivo e criar a contagem de uso do arquivo. Se o arquivo tiver sido instalado anteriormente, o programa de instalação apenas incrementará a contagem de uso do arquivo.

Se uma versão mais antiga do Gerenciador de Driver tiver sido instalada anteriormente pelo programa de instalação do aplicativo, os componentes principais deverão ser desinstalados e reinstalados para que a contagem de uso do componente principal seja válida. SQLRemoveDriverManager deve primeiro ser chamado para diminuir a contagem de uso do componente. SQLInstallDriverManager deve ser chamado para incrementar a contagem de uso do componente. O programa de instalação do aplicativo deve substituir os arquivos de componentes principais antigos pelos novos arquivos. As contagens de uso de arquivo permanecerão as mesmas, e outros aplicativos que usaram os arquivos de componentes principais da versão mais antiga agora usarão os arquivos de versão mais recentes.

Em uma nova instalação dos componentes principais, drivers e tradutores do ODBC, o programa de instalação do aplicativo deve chamar as seguintes funções em sequência: SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (com uma fRequest de ODBC_INSTALL_DRIVER) e, em seguida, SQLInstallTranslatorEx. Em uma desinstalação dos principais componentes, drivers e tradutores, o programa de instalação do aplicativo deve chamar as seguintes funções em sequência: SQLRemoveTranslator, SQLRemoveDriver e, em seguida, SQLRemoveDriverManager. Essas funções devem ser chamadas nessa sequência. Em uma atualização de todos os componentes, todas as funções de desinstalação devem ser chamadas em sequência e, em seguida, todas as funções de instalação devem ser chamadas em sequência.

Funções relacionadas

Para obter informações sobre	Consulte
Adicionar, modificar ou remover um driver	SQLConfigDriver
Instalando um driver	SQLInstallDriverEx
Instalando um tradutor	SQLInstallTranslatorEx
Removendo um driver	SQLRemoveDriver
Removendo o Gerenciador de Driver	SQLRemoveDriverManager
Removendo um tradutor	SQLRemoveTranslator