Condividi tramite

Informazioni di riferimento sulle API DLL del programma di installazione

Si applica a:SQL Server, Database SQL di Azure e Istanza gestita di SQL di Azure.

L'API DLL del programma di installazione fornisce funzioni per la gestione a livello di codice di origini dati ODBC, driver e traduttori. Le applicazioni e i programmi di installazione usano queste funzioni per installare, configurare e rimuovere componenti ODBC e per gestire le informazioni del Registro di sistema. Microsoft scrive e ridistribuisce la DLL del programma di installazione.

L'API è costituita da 25 funzioni. Tre di queste funzioni, SQLGetTranslator, SQLRemoveDSNFromInie SQLWriteDSNToIni, vengono chiamate solo dalle DLL di installazione. I programmi di installazione e amministrazione chiamano le altre funzioni.

Ogni funzione viene etichettata con la versione di ODBC in cui è stata introdotta.

Configurazione dell'origine dati

Queste funzioni creano, modificano e rimuovono origini dati ODBC a livello di codice. Usarli quando si creano programmi di installazione personalizzati o applicazioni che devono configurare le connessioni all'origine dati senza interazione dell'utente.

Funzione Description
SQLConfigDataSource Aggiunge, modifica o elimina un'origine dati. Chiama la DLL di installazione del driver per eseguire la configurazione effettiva.
SQLCreateDataSource Visualizza una finestra di dialogo che consente agli utenti di aggiungere un'origine dati in modo interattivo.
SQLManageDataSources Visualizza una finestra di dialogo per la gestione delle origini dati e delle opzioni di traccia, analogamente all'amministratore origine dati ODBC.
SQLValidDSN Controlla la lunghezza e la validità di un nome di origine dati prima che venga scritto nel Registro di sistema.
SQLReadFileDSN Legge le informazioni di connessione da un nome di origine dati basato su file (file con estensione dsn).
SQLWriteFileDSN Scrive le informazioni di connessione in un nome di origine dati basato su file (file con estensione dsn).
SQLRemoveDefaultDataSource Rimuove l'origine dati predefinita dalle informazioni di sistema.

Installazione e rimozione dei driver

Queste funzioni installano e rimuovono i driver ODBC dal sistema. Gestiscono le voci del Registro di sistema e i conteggi di utilizzo per supportare più applicazioni che condividono gli stessi driver.

Funzione Description
SQLInstallDriverEx Aggiunge informazioni sul driver al Registro di sistema e incrementa il numero di utilizzo del driver. Restituisce la directory di destinazione per i file driver.
SQLInstallDriverManager Restituisce la directory di destinazione per l'installazione dei componenti principali ODBC. Deprecato in ODBC 3.0 perché Gestione driver fa parte di Windows.
SQLRemoveDriver Rimuove le informazioni sul driver dal Registro di sistema. Decrementa il numero di utilizzo del driver e rimuove le voci del Registro di sistema quando il conteggio raggiunge zero.
SQLRemoveDriverManager Decrementa il numero di utilizzo dei componenti principali ODBC. Deprecato perché Gestione driver fa ora parte di Windows.
SQLConfigDriver Carica la DLL di installazione di un driver e chiama la relativa ConfigDriver funzione per eseguire attività di configurazione specifiche del driver.

Installazione e rimozione di Translator

Queste funzioni gestiscono i traduttori ODBC, che convertono i dati tra set di caratteri, ad esempio ANSI in Unicode. Usarli quando l'applicazione richiede la conversione dei dati durante la comunicazione con un'origine dati.

Funzione Description
SQLInstallTranslatorEx Aggiunge le informazioni del traduttore al Registro di sistema e incrementa il conteggio di utilizzo del traduttore.
SQLInstallTranslator Installa un traduttore. Deprecato; usare SQLInstallTranslatorEx invece .
SQLRemoveTranslator Rimuove le informazioni del traduttore dal Registro di sistema. Decrementa il numero di utilizzo e rimuove le voci quando il conteggio raggiunge lo zero.
SQLGetTranslator Visualizza una finestra di dialogo per la selezione di un traduttore. Chiamato dalle DLL di installazione del driver per richiedere agli utenti la selezione del traduttore.

Utilità di registro e configurazione

Queste funzioni leggono e scrivono dati di configurazione nella sezione ODBC del Registro di sistema di Windows. Altre funzioni del programma di installazione e DLL di installazione del driver le usano internamente.

Funzione Description
SQLWriteDSNToIni Aggiunge un nome di origine dati al Registro di sistema. Chiamato dalle DLL di installazione del driver durante la creazione di una nuova origine dati.
SQLRemoveDSNFromIni Rimuove un nome di origine dati dal Registro di sistema. Chiamato dalle DLL di installazione del driver durante l'eliminazione di un'origine dati.
SQLGetPrivateProfileString Legge un valore da una sottochiave della specifica dell'origine dati nel Registro di sistema.
SQLWritePrivateProfileString Scrive un valore in una sottochiave della specifica dell'origine dati nel Registro di sistema.
SQLGetInstalledDrivers Restituisce un elenco di driver ODBC installati dal Registro di sistema.
SQLGetConfigMode Recupera la modalità di configurazione che indica il percorso del Registro di sistema (utente o sistema) utilizzato per le voci dell'origine dati.
SQLSetConfigMode Imposta la modalità di configurazione che indica dove vengono scritte le voci dell'origine dati nel Registro di sistema.

Gestione degli errori

Queste funzioni forniscono informazioni sull'errore quando le funzioni del programma di installazione hanno esito negativo.

Funzione Description
SQLInstallerError Restituisce informazioni sullo stato o sull'errore per le funzioni del programma di installazione. Ogni funzione nella DLL del programma di installazione invia zero o più errori che possono essere recuperati da questa funzione.
SQLPostInstallerError Consente alle DLL di installazione del driver di segnalare gli errori alla coda degli errori del programma di installazione in modo che SQLInstallerError possano restituirli.

Contenuti correlati

  • Last updated on