Condividi tramite

Funzione SQLRemoveDSNFromIni

  • Articolo

Conformità
Versione introdotta: ODBC 1.0

Riepilogo
SQLRemoveDSNFromIni rimuove un'origine dati dalle informazioni di sistema.

Sintassi

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);

Argomenti

lpszDSN
[Input] Nome dell'origine dati da rimuovere.

Resi

La funzione restituisce TRUE se rimuove l'origine dati o l'origine dati non è presente nel file Odbc.ini. Restituisce FALSE se non riesce a rimuovere l'origine dati.

Diagnostica

Quando SQLRemoveDSNFromIni restituisce FALSE, è possibile ottenere un valore *pfErrorCode associato chiamando SQLInstallerError. 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_INVALID_DSN DSN non valido L'argomento lpszDSN non è valido.
ODBC_ERROR_REQUEST_FAILED Richiesta non riuscita Il programma di installazione non è riuscito a rimuovere le informazioni DSN dal Registro di sistema.
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

SQLRemoveDSNFromIni rimuove il nome dell'origine dati dalla sezione [Origini dati ODBC] delle informazioni di sistema. Rimuove anche la sezione specifica dell'origine dati dalle informazioni di sistema.

Questa funzione deve essere chiamata solo da una libreria di installazione driver.

Per informazioni su Vedere
Aggiunta, modifica o rimozione di un'origine dati ConfigDSN
Aggiunta, modifica o rimozione di un'origine dati SQLConfigDataSource
Rimozione dell'origine dati predefinita SQLRemoveDefaultDataSource
Aggiunta di un nome di origine dati alle informazioni di sistema SQLWriteDSNToIni