Condividi tramite

Funzione SQLSetConfigMode

  • Articolo

Conformità
Versione introdotta: ODBC 3.0

Riepilogo
SQLSetConfigMode imposta la modalità di configurazione che indica dove la voce Odbc.ini elenca i valori DSN si trova nelle informazioni di sistema.

Sintassi

  
BOOL SQLSetConfigMode(  
     UWORD     wConfigMode);

Argomenti

wConfigMode
[Input] Modalità di configurazione del programma di installazione (vedere "Commenti"). Il valore in wConfigMode può essere:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Resi

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

Diagnostica

Quando SQLSetConfigMode 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_INVALID_PARAM_SEQUENCE Sequenza di parametri non valida L'argomento wConfigMode non contiene ODBC_USER_DSN, ODBC_SYSTEM_DSN o ODBC_BOTH_DSN.

Commenti

Questa funzione viene utilizzata per impostare dove la voce Odbc.ini che elenca i valori DSN si trova nelle informazioni di sistema. Se wConfigMode è ODBC_USER_DSN, il DSN è un DSN utente e la funzione legge dalla voce Odbc.ini in HKEY_CURRENT_USER. Se è ODBC_SYSTEM_DSN, il DSN è un DSN di sistema e la funzione legge dalla voce Odbc.ini in HKEY_LOCAL_MACHINE. Se è ODBC_BOTH_DSN, HKEY_CURRENT_USER viene provato e, in caso di errore, viene usato HKEY_LOCAL_MACHINE.

Questa funzione non influisce su SQLCreateDataSource e SQLDriverConnect. La modalità di configurazione deve essere impostata quando un driver legge dal Registro di sistema chiamando SQLGetPrivateProfileString o scrive nel Registro di sistema chiamando SQLWritePrivateProfileString. Le chiamate a SQLGetPrivateProfileString e SQLWritePrivateProfileString usano la modalità di configurazione per conoscere la parte del Registro di sistema su cui operare.

Attenzione

SQLSetConfigMode deve essere chiamato solo quando necessario. Se la modalità è impostata in modo non corretto, il programma di installazione ODBC potrebbe non funzionare correttamente.

SQLSetConfigMode apporta una modifica diretta del Registro di sistema della modalità di configurazione. A parte il processo di modifica della modalità di configurazione tramite una chiamata a SQLConfigDataSource. Una chiamata a SQLConfigDataSource imposta la modalità di configurazione per distinguere i DSN utente e di sistema durante la modifica di un DSN. Prima della restituzione, SQLConfigDataSource reimposta la modalità di configurazione su BOTHDSN.

Per informazioni su Vedere
Creazione di un'origine dati SQLCreateDataSource
Connessione a un'origine dati tramite una stringa di connessione o una finestra di dialogo SQLDriverConnect
Recupero della modalità di configurazione SQLGetConfigMode