Función SQLSetConfigMode

Conformidad
Versión introducida: ODBC 3.0

Resumen
SQLSetConfigMode establece 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 SQLSetConfigMode(  
     UWORD     wConfigMode);  

Argumentos

wConfigMode
[Entrada] Modo de configuración del instalador (vea "Comentarios"). El valor de wConfigMode puede ser:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

Devoluciones

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

Diagnóstico

Cuando SQLSetConfigMode 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 en el contexto de esta función.

*pfErrorCode	Error	Descripción
ODBC_ERROR_INVALID_PARAM_SEQUENCE	Secuencia de parámetros no válida	El argumento wConfigMode no contenía ODBC_USER_DSN, ODBC_SYSTEM_DSN ni ODBC_BOTH_DSN.

Comentarios

Esta función se usa para establecer dónde se encuentra la información del sistema en la Odbc.ini entrada que enumera los valores de DSN. Si wConfigMode está ODBC_USER_DSN, el DSN es un DSN de usuario y la función lee de la entrada de 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 es ODBC_BOTH_DSN, se intenta HKEY_CURRENT_USER y, si se produce un error, se usa HKEY_LOCAL_MACHINE.

Esta función no afecta a SQLCreateDataSource y SQLDriverConnect. El modo de configuración debe establecerse cuando un controlador lee del Registro mediante una llamada a SQLGetPrivateProfileString o escribe en el registro mediante una llamada a SQLWritePrivateProfileString. Las llamadas a SQLGetPrivateProfileString y SQLWritePrivateProfileString usan el modo de configuración para saber en qué parte del registro operar.

Precaución

Solo se debe llamar a SQLSetConfigMode cuando sea necesario; si el modo está establecido incorrectamente, es posible que el instalador odbc no funcione correctamente.

SQLSetConfigMode realiza una modificación directa del Registro del modo de configuración. Esto se diferencia del proceso de modificación del modo de configuración mediante una llamada a SQLConfigDataSource. Una llamada a SQLConfigDataSource establece el modo de configuración para distinguir los DSN del usuario y del sistema al modificar un DSN. Antes de devolver, SQLConfigDataSource restablece el modo de configuración a BOTHDSN.

Funciones relacionadas

Para información acerca de	Vea
Creación de un origen de datos	SQLCreateDataSource
Conexión a un origen de datos mediante una cadena de conexión o un cuadro de diálogo	SQLDriverConnect
Recuperación del modo de configuración	SQLGetConfigMode