Compartir a través de

Función SQLRemoveDSNFromIni

  • Artículo

Conformidad
Versión introducida: ODBC 1.0

Resumen
SQLRemoveDSNFromIni quita un origen de datos de la información del sistema.

Sintaxis

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);

Argumentos

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

Devoluciones

La función devuelve TRUE si quita el origen de datos o el origen de datos no estaba en el archivo Odbc.ini. Devuelve FALSE si no se puede quitar el origen de datos.

Diagnóstico

Cuando SQLRemoveDSNFromIni 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_INVALID_DSN DSN no válido El argumento lpszDSN no era válido.
ODBC_ERROR_REQUEST_FAILED Error en la solicitud El instalador no pudo quitar la información de DSN del 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

SQLRemoveDSNFromIni quita el nombre del origen de datos de la sección [Orígenes de datos ODBC] de la información del sistema. También quita la sección de especificación del origen de datos de la información del sistema.

Solo se debe llamar a esta función desde una biblioteca de configuración de controladores.

Para información acerca de Vea
Agregar, modificar o quitar un origen de datos ConfigDSN
Agregar, modificar o quitar un origen de datos SQLConfigDataSource
Eliminación del origen de datos predeterminado SQLRemoveDefaultDataSource
Adición de un nombre de origen de datos a la información del sistema SQLWriteDSNToIni