Функция SQLRemoveDSNFromIni

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

Сводка
SQLRemoveDSNFromIni удаляет источник данных из системных сведений.

Синтаксис

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);  

Аргументы

lpszDSN
[Входные данные] Имя источника данных для удаления.

Возвраты

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

Диагностика

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

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

Комментарии

SQLRemoveDSNFromIni удаляет имя источника данных из раздела [Источники данных ODBC] системной информации. Он также удаляет раздел спецификации источника данных из системных сведений.

Эта функция должна вызываться только из библиотеки установки драйвера.

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