SQLManageDataSources

de conformidad de
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.

Devuelve

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

Diagnósticos

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

Administración de 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.

Cuadro de diálogo Administrador de orígenes de datos ODBC de

El cuadro de diálogo muestra los orígenes de datos enumerados en la información del sistema en tres pestañas: DSN de usuario, DSN del sistemay 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.

CH23F

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 lo 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 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 para 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 la misma máquina. También puede ser utilizado por un servicio de todo el sistema, que 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 de HKEY_LOCAL_MACHINE en la información del sistema en lugar de en la entrada de 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 de 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, como 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 se puede compartir, en cuyo caso el archivo .dsn reside en una red y varios usuarios pueden usar simultáneamente en la red siempre que el usuario tenga instalado el controlador adecuado. Un origen de datos de archivo también puede no ser compartido, 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 archivoso vea SQLDriverConnect.

Administración de controladores

Si el usuario hace clic en la pestaña controladores de 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 que se muestra es la fecha de creación del controlador, como se muestra en la ilustración siguiente.

Opciones de seguimiento

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 de 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 con el nombre especificado.

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 hace clic en Detener el analizador de Visual Studio.

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

Funciones relacionadas