Поделиться через

Функция SQLValidDSN

  • Статья

Соответствия
Представлена версия: ODBC 2.0

Сводка
SQLValidDSN проверяет длину и допустимость имени источника данных перед добавлением имени в системную информацию.

Синтаксис

  
BOOL SQLValidDSN(  
     LPCSTR    lpszDSN);

Аргументы

lpszDSN
[Входные данные] Проверяемое имя источника данных.

Возвраты

Функция возвращает значение TRUE, если имя источника данных является допустимым. Возвращает значение FALSE, если имя источника данных недопустимо или сбой вызова функции.

Диагностика

Когда SQLValidDSN возвращает значение FALSE, связанное значение *pfErrorCode можно получить путем вызова SQLInstallerError. Значение *pfErrorCode возвращается только в том случае, если вызов функции завершился ошибкой, а не возвращается значение FALSE, так как имя источника данных недопустимо. В следующей таблице перечислены значения *pfErrorCode , которые можно возвращать SQLInstallerError и объясняет каждый из них в контексте этой функции.

*pfErrorCode Error Description
ODBC_ERROR_GENERAL_ERR Общая ошибка установщика Произошла ошибка, для которой не было определенной ошибки установщика.
ODBC_ERROR_OUT_OF_MEM Недостаточно памяти Установщик не мог выполнить функцию из-за нехватки памяти.

Комментарии

SQLValidDSN вызывается драйвером ConfigDSN, чтобы проверить длину имени источника данных и допустимость отдельных символов в имени источника данных. Он проверяет, превышает ли длина имени SQL_MAX_DSN_LENGTH, как определено в Sqlext.h. (Длина имени источника данных также проверяется SQLWriteDSNToIni.) SQLValidDSN проверяет, включены ли какие-либо из следующих недопустимых символов в имя источника данных:

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

Сведения Раздел
Добавление, изменение или удаление источника данных ConfigDSN (в библиотеке DLL установки)
Добавление, изменение или удаление источника данных SQLConfigDataSource
Запись имени источника данных в системную информацию SQLWriteDSNToIni