Compartir a través de

Función SQLWriteDSNToIni

  • Artículo

Conformidad
Versión introducida: ODBC 1.0

Resumen
SQLWriteDSNToIni agrega un origen de datos a la información del sistema.

Sintaxis

  
BOOL SQLWriteDSNToIni(  
     LPCSTR   lpszDSN,  
     LPCSTR   lpszDriver);

Argumentos

lpszDSN
[Entrada] Nombre del origen de datos que se va a agregar.

lpszDriver
[Entrada] Descripción del controlador (normalmente el nombre del DBMS asociado) presentado a los usuarios en lugar del nombre del controlador físico.

Devoluciones

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

Diagnóstico

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

*pfErrorCode Error Descripción
ODBC_ERROR_GENERAL_ERR Error general del instalador Error por el que no se produjo ningún error de instalador específico.
ODBC_ERROR_INVALID_DSN DSN no válido El argumento lpszDSN contenía una cadena que no era válida para un DSN.
ODBC_ERROR_INVALID_NAME Nombre de controlador o traductor no válido El argumento lpszDriver no era válido.
ODBC_ERROR_REQUEST_FAILED Error en la solicitud El instalador no pudo crear un DSN en el registro.
ODBC_ERROR_OUT_OF_MEM No hay memoria suficiente El instalador no pudo realizar la función debido a una falta de memoria.

Comentarios

SQLWriteDSNToIni agrega el origen de datos a la sección [Orígenes de datos ODBC] de la información del sistema. A continuación, crea una sección de especificación para el origen de datos y agrega una sola palabra clave (Driver) con el nombre del archivo DLL del controlador como su valor. Si la sección de especificación del origen de datos ya existe, SQLWriteDSNToIni quita la sección anterior antes de crear la nueva.

El autor de la llamada de esta función debe agregar cualquier palabra clave y valores específicos del controlador a la sección especificación del origen de datos de la información del sistema.

Si el nombre del origen de datos es Default, SQLWriteDSNToIni también crea la sección de especificación del controlador predeterminada en la información del sistema.

Solo se debe llamar a esta función desde un archivo DLL de instalación.

Para información acerca de Vea
Adición, modificación o eliminación de un origen de datos ConfigDSN(en el archivo DLL de instalación)
Adición, modificación o eliminación de un origen de datos SQLConfigDataSource
Eliminación de un nombre de origen de datos de la información del sistema SQLRemoveDSNFromIni