SQLManageDataSources

Conformità
Versione introdotta: ODBC 2.0

Riepilogo
SQLManageDataSources visualizza una finestra di dialogo con cui gli utenti possono configurare, aggiungere ed eliminare origini dati nelle informazioni di sistema.

Sintassi

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Argomenti

hwnd
[Input] Handle della finestra padre.

Resi

SQLManageDataSources restituisce FALSE se hwnd non è un handle di finestra valido. In caso contrario, restituisce TRUE.

Diagnostica

Quando SQLManageDataSources 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.

Gestione delle origini dati

SQLManageDataSources visualizza inizialmente la finestra di dialogo Amministratore origine dati ODBC, come illustrato nella figura seguente.

Nella finestra di dialogo vengono visualizzate le origini dati elencate nelle informazioni di sistema in tre schede: DSN utente, DSN di sistema e DSN file. Se l'utente fa doppio clic su un'origine dati o seleziona un'origine dati e fa clic su Configura, SQLManageDataSources chiama ConfigDSN nella DLL di installazione con l'opzione ODBC_CONFIG_DSN.

Se l'utente fa clic su Aggiungi, SQLManageDataSources visualizza la finestra di dialogo Crea nuova origine dati, illustrata nella figura seguente.

Nella finestra di dialogo viene visualizzato un elenco di driver installati. Se l'utente fa doppio clic su un driver o seleziona un driver e fa clic su OK, SQLManageDataSources chiama ConfigDSN nella DLL di installazione e lo passa all'opzione ODBC_ADD_DSN.

Se l'utente seleziona un'origine dati e fa clic su Rimuovi, SQLManageDataSources chiede se l'utente vuole eliminare l'origine dati. Se l'utente fa clic su Sì, SQLManageDataSources chiama ConfigDSN nella DLL di installazione con l'opzione ODBC_REMOVE_DSN.

La finestra di dialogo Crea nuova origine dati consente di aggiungere o eliminare un'origine dati utente, un'origine dati di sistema o un'origine dati file.

DSN utente

I DSN creati per singoli utenti verranno chiamati DSN utente per distinguerli dai DSN di sistema. I DSN utente vengono registrati come indicato di seguito nelle informazioni di sistema:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

DSN di sistema

La finestra di dialogo Crea nuova origine dati consente di aggiungere un'origine dati di sistema al computer locale o di eliminarla oppure di impostare la configurazione per un'origine dati di sistema.

Un'origine dati configurata con un nome DSN (System Data Source Name) può essere usata da più utenti nello stesso computer. Può anche essere usato da un servizio a livello di sistema, che può quindi ottenere l'accesso all'origine dati anche se nessun utente è connesso al computer.

Un DSN di sistema viene registrato nella voce HKEY_LOCAL_MACHINE nelle informazioni di sistema anziché nella voce HKEY_CURRENT_USER. Non è associato a un utente che accede con il nome utente e la password specifici, ma può essere usato da qualsiasi utente del computer o da un servizio automatico a livello di sistema. Il DSN di sistema è tuttavia associato a un computer. Non supporta la funzionalità di utilizzo di DSN remoti tra computer. I DSN di sistema vengono registrati come indicato di seguito nelle informazioni di sistema:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

DSN file

Un'origine dati file non ha un nome di origine dati, come un'origine dati del computer e non è registrata in alcun utente o computer. Le informazioni di connessione per tale origine dati sono contenute in un file con estensione dsn che può essere copiato in qualsiasi computer. Un'origine dati file può essere condivisibile, nel qual caso il file con estensione dsn si trova in una rete e può essere usato contemporaneamente da più utenti in rete, purché l'utente abbia installato il driver appropriato. Un'origine dati file può anche essere non condivisibile, nel qual caso può essere usata solo in un singolo computer.

Per altre informazioni sulle origini dati dei file, vedere Connessione tramite origini dati file o vedere SQLDriverConnect.

Gestione dei driver

Se l'utente fa clic sulla scheda Driver nella finestra di dialogo Amministrazione origine dati ODBC, SQLManageDataSources visualizza un elenco di driver ODBC installati nel sistema, nonché informazioni sui driver. La data visualizzata è la data di creazione del driver, come illustrato nella figura seguente.

Opzioni di traccia

Se l'utente fa clic sulla scheda Traccia nella finestra di dialogo Amministrazione origine dati ODBC, SQLManageDataSources visualizza le opzioni di traccia, come illustrato nella figura seguente.

Se l'utente fa clic su Avvia traccia ora e quindi fa clic su OK, SQLManageDataSources abilita la traccia manualmente per tutte le applicazioni attualmente in esecuzione nel computer.

Se l'utente specifica il nome di un file di traccia nella casella di testo Percorso file di log e quindi fa clic su OK, SQLManageDataSources imposta la parola chiave TraceFile nella sezione [ODBC] delle informazioni di sistema sul nome specificato.

Se l'utente fa clic su Avvia Visual Studio Analyzer e quindi fa clic su OK, Visual Studio Analyzer è abilitato. Rimane abilitato fino a quando non si fa clic su Arresta Visual Studio Analyzer .

Per altre informazioni sulla traccia, vedere Traccia. Per altre informazioni sulle parole chiave Trace e TraceFile , vedere Sottochiave ODBC.

Funzioni correlate