Función SQLWriteDSNToIni

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.

Funciones relacionadas

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