Condividi tramite

Funzione SQLInstallDriverManager

  • Articolo

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

Riepilogo
SQLInstallDriverManager restituisce il percorso della directory di destinazione per l'installazione dei componenti principali ODBC. Il programma chiamante deve effettivamente copiare i file di Gestione driver nella directory di destinazione.

Sintassi

  
BOOL SQLInstallDriverManager(  
     LPSTR    lpszPath,  
     WORD     cbPathMax,  
     WORD *   pcbPathOut);

Argomenti

lpszPath
[Output] Percorso della directory di destinazione dell'installazione.

cbPathMax
[Input] Lunghezza di lpszPath. Deve essere almeno _MAX_PATH byte.

pcbPathOut
[Output] Numero totale di byte (escluso il byte di terminazione Null) restituito in lpszPath. Se il numero di byte disponibili per la restituzione è maggiore o uguale a cbPathMax, il percorso in lpszPath viene troncato a cbPathMax meno il carattere di terminazione null. L'argomento pcbPathOut può essere un puntatore Null.

Resi

Se ha esito positivo, la funzione restituisce TRUE se ha esito negativo.

Diagnostica

Quando SQLInstallDriverManager 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_BUFF_LEN Lunghezza del buffer non valida L'argomento lpszPath non è sufficientemente grande da contenere il percorso di output. Il buffer contiene il percorso troncato.

L'argomento cbPathMax è minore di _MAX_PATH.
ODBC_ERROR_USAGE_UPDATE_FAILED Impossibile incrementare o decrementare il numero di utilizzo dei componenti Il programma di installazione non è riuscito ad incrementare il numero di utilizzo dei componenti principali ODBC.
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

SQLInstallDriverManager viene chiamato per restituire il percorso per i componenti principali ODBC e incrementare il numero di utilizzo dei componenti nelle informazioni di sistema. Se esiste già una versione di Gestione driver, ma il numero di utilizzo dei componenti per il driver non esiste, il nuovo valore del conteggio di utilizzo dei componenti è impostato su 2.

Il programma di installazione dell'applicazione è responsabile della copia fisica dei file dei componenti di base e della gestione dei conteggi di utilizzo dei file. Se un file di componenti di base non è stato installato in precedenza, il programma di installazione dell'applicazione deve copiare il file e creare il numero di utilizzo dei file. Se il file è stato installato in precedenza, il programma di installazione incrementa semplicemente il numero di utilizzo dei file.

Se una versione precedente di Gestione driver è stata installata in precedenza dal programma di installazione dell'applicazione, i componenti di base devono essere disinstallati e quindi reinstallati, in modo che il numero di utilizzo dei componenti principali sia valido. SQLRemoveDriverManager deve prima essere chiamato per decrementare il numero di utilizzo dei componenti. SQLInstallDriverManager 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 usavano i file dei componenti di base della versione meno recenti useranno ora i file di versione più recenti.

In una nuova installazione dei componenti di base, dei driver e dei traduttori ODBC, il programma di installazione dell'applicazione deve chiamare le funzioni seguenti in sequenza: SQLInstallDriverManager, SQLInstallDriverEx, SQLConfigDriver (con un fRequest di ODBC_INSTALL_DRIVER) e quindi SQLInstallTranslatorEx. In una disinstallazione dei componenti di base, dei driver e dei traduttori, il programma di installazione dell'applicazione deve chiamare le funzioni seguenti in sequenza: SQLRemoveTranslator, SQLRemoveDriver e quindi SQLRemoveDriverManager. Queste funzioni devono essere chiamate in questa sequenza. In un aggiornamento di tutti i componenti, tutte le funzioni di disinstallazione devono essere chiamate in sequenza e quindi tutte le funzioni di installazione devono essere chiamate in sequenza.

Per informazioni su Vedere
Aggiunta, modifica o rimozione di un driver SQLConfigDriver
Installazione di un driver SQLInstallDriverEx
Installazione di un traduttore SQLInstallTranslatorEx
Rimozione di un driver SQLRemoveDriver
Rimozione di Gestione driver SQLRemoveDriverManager
Rimozione di un traduttore SQLRemoveTranslator