Función SQLGetConfigMode

Conformidad
Versión introducida: ODBC 3.0

Resumen
SQLGetConfigMode recupera el modo de configuración que indica dónde se encuentra el Odbc.ini entrada que enumera los valores de DSN en la información del sistema.

Sintaxis

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

Argumentos

pwConfigMode
[Salida] Puntero al búfer que contiene el modo de configuración. (Vea "Comments.") El valor de *pwConfigMode puede ser:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Devoluciones

La función devuelve TRUE si se realiza correctamente, FALSE si se produce un error.

Diagnóstico

Cuando SQLGetConfigMode devuelve FALSE, se puede obtener un valor *pfErrorCode asociado mediante una llamada a SQLInstallerError. En la tabla siguiente se enumeran los valores *pfErrorCode que SQLInstallerError puede devolver y explica cada uno de ellos en el contexto de esta función.

*pfErrorCode	Error	Descripción
ODBC_ERROR_OUT_OF_MEM	No hay memoria suficiente	El instalador no pudo realizar la función debido a una falta de memoria.

Comentarios

Esta función se usa para determinar dónde se encuentra el Odbc.ini entrada que enumera los valores de DSN en la información del sistema. Si *pwConfigMode es ODBC_USER_DSN, el DSN es un DSN de usuario y la función lee de la entrada Odbc.ini en HKEY_CURRENT_USER. Si es ODBC_SYSTEM_DSN, el DSN es un DSN del sistema y la función lee de la entrada de Odbc.ini en HKEY_LOCAL_MACHINE. Si se ODBC_BOTH_DSN, se intenta HKEY_CURRENT_USER y, si se produce un error, se usa HKEY_LOCAL_MACHINE.

De forma predeterminada, SQLGetConfigMode devuelve ODBC_BOTH_DSN. Cuando se crea un DSN de usuario o un DSN del sistema mediante una llamada a SQLConfigDataSource, la función establece el modo de configuración en ODBC_USER_DSN o ODBC_SYSTEM_DSN distinguir los DSN del usuario y del sistema al modificar un DSN. Antes de devolver, SQLConfigDataSource restablece el modo de configuración a ODBC_BOTH_DSN.

Funciones relacionadas

Para información acerca de	Vea
Establecimiento del modo de configuración	SQLSetConfigMode