Функция 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