Partilhar via


Função SQLRemoveDSNFromIni

Conformidade
Versão introduzida: ODBC 1.0

Resumo
SQLRemoveDSNFromIni remove uma fonte de dados das informações do sistema.

Sintaxe

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);  

Argumentos

lpszDSN
[Entrada] Nome da fonte de dados a ser removida.

Retornos

A função retornará TRUE se remover a fonte de dados ou se a fonte de dados não estiver no arquivo Odbc.ini. Ele retornará FALSE se não conseguir remover a fonte de dados.

Diagnósticos

Quando SQLRemoveDSNFromIni 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 erro específico do instalador.
ODBC_ERROR_INVALID_DSN DSN inválida O argumento lpszDSN era inválido.
ODBC_ERROR_REQUEST_FAILED Falha na solicitação O instalador não pôde remover as informações de DSN do registro.
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

SQLRemoveDSNFromIni remove o nome da fonte de dados da seção [Fontes de Dados ODBC] das informações do sistema. Ele também remove a seção de especificação da fonte de dados das informações do sistema.

Essa função deve ser chamada somente de uma biblioteca de configuração do driver.

Para obter informações sobre Consulte
Adicionar, modificar ou remover uma fonte de dados Configdsn
Adicionar, modificar ou remover uma fonte de dados SQLConfigDataSource
Removendo a fonte de dados padrão SQLRemoveDefaultDataSource
Adicionando um nome de fonte de dados às informações do sistema SQLWriteDSNToIni