Condividi tramite

Funzione SQLValidDSN

  • Articolo

Conformità
Versione introdotta: ODBC 2.0

Riepilogo
SQLValidDSN controlla la lunghezza e la validità del nome dell'origine dati prima che il nome venga aggiunto alle informazioni di sistema.

Sintassi

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Argomenti

lpszDSN
[Input] Nome origine dati da controllare.

Resi

La funzione restituisce TRUE se il nome dell'origine dati è valido. Restituisce FALSE se il nome dell'origine dati non è valido o la chiamata di funzione non è riuscita.

Diagnostica

Quando SQLValidDSN restituisce FALSE, è possibile ottenere un valore *pfErrorCode associato chiamando SQLInstallerError. Viene restituito *pfErrorCode solo se la chiamata di funzione non è riuscita, non se è stato restituito FALSE perché il nome dell'origine dati non è valido. Nella tabella seguente sono elencati i valori *pfErrorCode che possono essere restituiti da SQLInstallerError e spiega ognuno nel contesto di questa funzione.

*pfErrorCode Errore Descrizione
ODBC_ERROR_GENERAL_ERR Errore generale del programma di installazione Si è verificato un errore per il quale non si è verificato un errore specifico del programma di installazione.
ODBC_ERROR_OUT_OF_MEM Memoria insufficiente Il programma di installazione non è riuscito a eseguire la funzione a causa di una mancanza di memoria.

Commenti

SQLValidDSN viene chiamato da ConfigDSN di un driver per controllare la lunghezza del nome dell'origine dati e la validità dei singoli caratteri nel nome dell'origine dati. Verifica se la lunghezza del nome è maggiore di SQL_MAX_DSN_LENGTH, come definito in Sqlext.h. La lunghezza del nome dell'origine dati viene controllata anche da SQLWriteDSNToIni. SQLValidDSN verifica se uno dei caratteri non validi seguenti è incluso nel nome dell'origine dati:

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

Per informazioni su Vedere
Aggiunta, modifica o rimozione di un'origine dati ConfigDSN (nella DLL di installazione)
Aggiunta, modifica o rimozione di un'origine dati SQLConfigDataSource
Scrittura di un nome di origine dati nelle informazioni di sistema SQLWriteDSNToIni