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.

Funções relacionadas

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