Compartir a través de

Función SQLValidDSN

  • Artículo

Conformidad
Versión introducida: ODBC 2.0

Resumen
SQLValidDSN comprueba la longitud y validez del nombre del origen de datos antes de agregar el nombre a la información del sistema.

Sintaxis

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Argumentos

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

Devoluciones

La función devuelve TRUE si el nombre del origen de datos es válido. Devuelve FALSE si el nombre del origen de datos no es válido o se produjo un error en la llamada de función.

Diagnóstico

Cuando SQLValidDSN devuelve FALSE, se puede obtener un valor *pfErrorCode asociado llamando a SQLInstallerError. Solo se devuelve un *pfErrorCode si se produjo un error en la llamada de función, no si se devolvió FALSE porque el nombre del origen de datos no es válido. 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_OUT_OF_MEM No hay memoria suficiente El instalador no pudo realizar la función debido a una falta de memoria.

Comentarios

El configDSN de un controlador llama a SQLValidDSN para comprobar la longitud del nombre del origen de datos y la validez de los caracteres individuales en el nombre del origen de datos. Comprueba si la longitud del nombre es mayor que SQL_MAX_DSN_LENGTH, tal como se define en Sqlext.h. ( SqlWriteDSNToIni también comprueba la longitud del nombre del origen de datos). SQLValidDSN comprueba si alguno de los siguientes caracteres no válidos se incluye en el nombre del origen de datos:

[ ] { } ( ) , ; ? * = ! @ \

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
Escribir un nombre de origen de datos en la información del sistema SQLWriteDSNToIni