Compartilhar via

Função SQLValidDSN

  • Artigo

Conformidade
Versão introduzida: ODBC 2.0

Resumo
SQLValidDSN verifica o comprimento e a validade do nome da fonte de dados antes que o nome seja adicionado às informações do sistema.

Sintaxe

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Argumentos

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

Retornos

A função retornará TRUE se o nome da fonte de dados for válido. Ele retornará FALSE se o nome da fonte de dados for inválido ou a chamada de função falhar.

Diagnósticos

Quando SQLValidDSN retorna FALSE, um valor *pfErrorCode associado pode ser obtido chamando SQLInstallerError. Um *pfErrorCode será retornado somente se a chamada de função falhar, não se FALSE tiver sido retornado porque o nome da fonte de dados é inválido. 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_OUT_OF_MEM Memória insuficiente O instalador não pôde executar a função devido à falta de memória.

Comentários

SQLValidDSN é chamado pelo ConfigDSN de um driver para verificar o comprimento do nome da fonte de dados e a validade dos caracteres individuais no nome da fonte de dados. Ele verifica se o comprimento do nome é maior que SQL_MAX_DSN_LENGTH, conforme definido em Sqlext.h. (O comprimento do nome da fonte de dados também é verificado por SQLWriteDSNToIni.) SQLValidDSN verifica se algum dos seguintes caracteres inválidos está incluído no nome da fonte de dados:

[ ] { } ( ) , ; ? * = ! @ \

Para obter informações sobre Consulte
Adicionar, modificar ou remover uma fonte de dados ConfigDSN (na DLL de Instalação)
Adicionar, modificar ou remover uma fonte de dados SQLConfigDataSource
Gravando um nome de fonte de dados nas informações do sistema SQLWriteDSNToIni