Condividi tramite

Funzione SQLRemoveDriverManager

  • Articolo

Conformità
Versione introdotta: ODBC 3.0: deprecata in Windows XP Service Pack 2, Windows Server 2003 Service Pack 1 e sistemi operativi successivi.

Riepilogo
SQLRemoveDriverManager modifica o rimuove informazioni sui componenti principali ODBC dalla voce Odbcinst.ini nelle informazioni di sistema.

Sintassi

  
BOOL SQLRemoveDriverManager(  
     LPDWORD     pdwUsageCount);

Argomenti

pdwUsageCount
[Output] Numero di utilizzo di Gestione driver dopo la chiamata di questa funzione.

Resi

Se ha esito positivo, la funzione restituisce TRUE se ha esito negativo. Se non esiste alcuna voce nelle informazioni di sistema quando questa funzione viene chiamata, la funzione restituisce FALSE.

Diagnostica

Quando SQLRemoveDriverManager 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_COMPONENT_NOT_FOUND Componente non trovato nel Registro di sistema Il programma di installazione non è riuscito a rimuovere le informazioni di Gestione driver perché non esisteva nel Registro di sistema o non è stato trovato nel Registro di sistema.
ODBC_ERROR_USAGE_UPDATE_FAILED Impossibile incrementare o decrementare il numero di utilizzo dei componenti Il programma di installazione non è riuscito a decrementare il numero di utilizzo di Gestione driver.
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

SQLRemoveDriverManager integra la funzione SQLInstallDriverManager e aggiorna il numero di utilizzo dei componenti nelle informazioni di sistema. Questa funzione deve essere chiamata solo da un'applicazione di installazione.

SQLRemoveDriverManager decrementerà il numero di utilizzo dei componenti principali di 1. Se il numero di utilizzo dei componenti passa a 0, le informazioni sul sistema di immissione verranno rimosse. La voce del componente principale si trova nella posizione seguente nelle informazioni di sistema, sotto il titolo "ODBC Core":

HKEY_LOCAL_MACHINE

SOFTWARE

ODBC

Odbcinst.ini

Attenzione

Un'applicazione non deve rimuovere fisicamente i file di Gestione driver quando il numero di utilizzo dei componenti e il numero di utilizzo dei file raggiunge lo zero.

SQLRemoveDriverManager non rimuove effettivamente alcun file. Il programma chiamante è responsabile dell'eliminazione dei file e della gestione dei conteggi di utilizzo dei file. I file di Gestione driver non devono tuttavia essere rimossi quando sia il numero di utilizzo dei componenti che il numero di utilizzo dei file hanno raggiunto zero, perché questi file possono essere usati da altre applicazioni che non hanno incrementato il numero di utilizzo dei file.

SQLRemoveDriverManager viene chiamato come parte del processo di disinstallazione. I componenti di base ODBC (che includono Gestione driver, Libreria di cursori, Programma di installazione, Libreria di linguaggio, Amministratore, file di disinstallazione e così via) vengono disinstallati nel suo complesso. I file seguenti non vengono rimossi quando SQLRemoveDriverManager viene chiamato come parte del processo di disinstallazione:

ODBC32DLL
ODBCCR32.DLL
ODBCCU32.DLL
ODBCINT.DLL
ODBCTRAC.DLL
MSVCRT40.DLL
ODBCCP32.CPL

ODBCCP32.DLL
ODBC16GT.DLL
ODBC32GT.DLL
DS16GT.DLL
DS32GT.DLL
ODBCAD32.EXE

SQLRemoveDriverManager viene chiamato anche come parte di un processo di aggiornamento. Se un'applicazione rileva che deve eseguire un aggiornamento e ha installato in precedenza il driver, il driver deve essere rimosso e quindi reinstallato.

SQLRemoveDriverManager deve prima essere chiamato per decrementare il numero di utilizzo dei componenti. SQLInstallDriverEx deve quindi essere chiamato per incrementare il numero di utilizzo dei componenti. Il programma di installazione dell'applicazione deve sostituire i file dei componenti principali precedenti con i nuovi file. I conteggi di utilizzo dei file rimarranno invariati e altre applicazioni che usano i file di componenti di base della versione meno recenti useranno ora i file di versione più recenti.

Per informazioni su Vedere
Installazione di Gestione driver SQLInstallDriverManager