Funzione SQLRemoveDSNFromIni

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.

Funzioni correlate

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