SQLManageDataSources

Conformidad
Versión introducida: ODBC 2.0

Resumen
SQLManageDataSources muestra un cuadro de diálogo con el que los usuarios pueden configurar, agregar y eliminar orígenes de datos en la información del sistema.

Sintaxis

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

Argumentos

hwnd
[Entrada] Identificador de ventana principal.

Devoluciones

SQLManageDataSources devuelve FALSE si hwnd no es un identificador de ventana válido. De lo contrario, devuelve TRUE.

Diagnóstico

Cuando SQLManageDataSources devuelve FALSE, se puede obtener un valor *pfErrorCode asociado llamando 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_GENERAL_ERR	Error general del instalador	Se produjo un error para el que no hubo ningún error de instalador específico.
ODBC_ERROR_REQUEST_FAILED	Error de solicitud	Error en la llamada a ConfigDSN .
ODBC_ERROR_INVALID__HWND	Identificador de ventana no válido	El argumento hwnd no era válido o NULL.
ODBC_ERROR_OUT_OF_MEM	No hay memoria suficiente	El instalador no pudo realizar la función debido a una falta de memoria.

Administrar orígenes de datos

SQLManageDataSources muestra inicialmente el cuadro de diálogo Administrador de orígenes de datos ODBC , como se muestra en la ilustración siguiente.

El cuadro de diálogo muestra los orígenes de datos que aparecen en la información del sistema en tres pestañas: DSN de usuario, DSN del sistema y DSN de archivo. Si el usuario hace doble clic en un origen de datos o selecciona un origen de datos y hace clic en Configurar, SQLManageDataSources llama a ConfigDSN en el archivo DLL de instalación con la opción ODBC_CONFIG_DSN.

Si el usuario hace clic en Agregar, SQLManageDataSources muestra el cuadro de diálogo Crear nuevo origen de datos, que se muestra en la ilustración siguiente.

El cuadro de diálogo muestra una lista de controladores instalados. Si el usuario hace doble clic en un controlador o selecciona un controlador y hace clic en Aceptar, SQLManageDataSources llama a ConfigDSN en el archivo DLL de instalación y le pasa la opción ODBC_ADD_DSN.

Si el usuario selecciona un origen de datos y hace clic en Quitar, SQLManageDataSources pregunta si el usuario quiere eliminar el origen de datos. Si el usuario hace clic en Sí, SQLManageDataSources llama a ConfigDSN en el archivo DLL de instalación con la opción ODBC_REMOVE_DSN.

El cuadro de diálogo Crear nuevo origen de datos se usa para agregar o eliminar un origen de datos de usuario, un origen de datos del sistema o un origen de datos de archivo.

DSN de usuario

Los DSN creados para usuarios individuales se denominarán DSN de usuario, para distinguirlos de los DSN del sistema. Los DSN de usuario se registran de la siguiente manera en la información del sistema:

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

DSN del sistema

El cuadro de diálogo Crear nuevo origen de datos permite agregar un origen de datos del sistema al equipo local o eliminar uno, o bien establecer la configuración de un origen de datos del sistema.

Un origen de datos configurado con un nombre de origen de datos del sistema (DSN) puede ser utilizado por más de un usuario en el mismo equipo. También puede ser utilizado por un servicio de todo el sistema, que luego puede obtener acceso al origen de datos incluso si ningún usuario ha iniciado sesión en la máquina.

Un DSN del sistema se registra en la entrada HKEY_LOCAL_MACHINE en la información del sistema en lugar de en la entrada HKEY_CURRENT_USER. No está vinculado a un usuario que inicia sesión con su nombre de usuario y contraseña concretos, pero puede ser utilizado por cualquier usuario de esa máquina o por un servicio automático en todo el sistema. Sin embargo, el DSN del sistema está vinculado a una máquina. No admite la capacidad de usar DSN remotos entre máquinas. Los DSN del sistema se registran de la siguiente manera en la información del sistema:

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

DSN de archivo

Un origen de datos de archivo no tiene un nombre de origen de datos, al igual que un origen de datos de la máquina y no está registrado en ningún usuario o equipo. La información de conexión de ese origen de datos se encuentra en un archivo .dsn que se puede copiar en cualquier máquina. Un origen de datos de archivo puede compartirse, en cuyo caso el archivo .dsn reside en una red y se puede usar simultáneamente por varios usuarios de la red siempre y cuando el usuario tenga instalado el controlador adecuado. Un origen de datos de archivo también puede no compartirse, en cuyo caso solo se puede usar en una sola máquina.

Para obtener más información sobre los orígenes de datos de archivos, vea Conexión mediante orígenes de datos de archivos o vea SQLDriverConnect.

Administración de controladores

Si el usuario hace clic en la pestaña Controladores del cuadro de diálogo Administrador de orígenes de datos ODBC , SQLManageDataSources muestra una lista de controladores ODBC instalados en el sistema, así como información sobre los controladores. La fecha mostrada es la fecha de creación del controlador, como se muestra en la ilustración siguiente.

Pestaña

Opciones de traza

Si el usuario hace clic en la pestaña Seguimiento del cuadro de diálogo Administrador de orígenes de datos ODBC , SQLManageDataSources muestra las opciones de seguimiento, como se muestra en la ilustración siguiente.

Si el usuario hace clic en Iniciar seguimiento ahora y, a continuación, hace clic en Aceptar, SQLManageDataSources habilita el seguimiento manualmente para todas las aplicaciones que se ejecutan actualmente en la máquina.

Si el usuario especifica el nombre de un archivo de seguimiento en el cuadro de texto Ruta de acceso del archivo de registro y, a continuación, hace clic en Aceptar, SQLManageDataSources establece la palabra clave TraceFile en la sección [ODBC] de la información del sistema en el nombre especificado.

Importante

La compatibilidad con Visual Studio Analyzer se quitó a partir de Windows 8 (Visual Studio Analyzer solo se incluyó en versiones anteriores de Visual Studio). Para un mecanismo de solución de problemas alternativo, use el seguimiento de BID.

Si el usuario hace clic en Iniciar Analizador de Visual Studio y, a continuación, hace clic en Aceptar, visual Studio Analyzer está habilitado. Permanece habilitado hasta que se haga clic en Detener analizador de Visual Studio .

Para obtener más información sobre el seguimiento, vea Seguimiento. Para obtener más información sobre las palabras clave Trace y TraceFile , vea Subclave ODBC.

Funciones relacionadas

Para información acerca de	Vea
Creación de orígenes de datos	SQLCreateDataSource