Funzione SQLGetConfigMode

  • Articolo

Conformità
Versione introdotta: ODBC 3.0

Riepilogo
SQLGetConfigMode recupera la modalità di configurazione che indica dove la voce Odbc.ini elenca i valori DSN nelle informazioni di sistema.

Sintassi

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);

Argomenti

pwConfigMode
[Output] Puntatore al buffer contenente la modalità di configurazione. (Vedere "Comments.") Il valore in *pwConfigMode 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 SQLGetConfigMode 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_OUT_OF_MEM Memoria insufficiente Il programma di installazione non è riuscito a eseguire la funzione a causa di una mancanza di memoria.

Commenti

Questa funzione viene utilizzata per determinare dove la voce Odbc.ini che elenca i valori DSN si trova nelle informazioni di sistema. Se *pwConfigMode è 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.

Per impostazione predefinita, SQLGetConfigMode restituisce ODBC_BOTH_DSN. Quando un DSN utente o un DSN di sistema viene creato da una chiamata a SQLConfigDataSource, la funzione imposta la modalità di configurazione su ODBC_USER_DSN o ODBC_SYSTEM_DSN per distinguere gli DSN utente e di sistema durante la modifica di un DSN. Prima della restituzione, SQLConfigDataSource reimposta la modalità di configurazione su ODBC_BOTH_DSN.

Per informazioni su Vedere
Impostazione della modalità di configurazione SQLSetConfigMode