SQLRemoveDSNFromIni 函数

  • 项目

一致性
引入的版本：ODBC 1.0

摘要
SQLRemoveDSNFromIni 从系统信息中删除数据源。

语法

  
BOOL SQLRemoveDSNFromIni(  
     LPCSTR   lpszDSN);

参数

lpszDSN
[输入]要删除的数据源的名称。

返回

如果函数删除数据源或数据源不在Odbc.ini文件中，则返回 TRUE。 如果无法删除数据源，则返回 FALSE。

诊断

当 SQLRemoveDSNFromIni 返回 FALSE 时，可以通过调用 SQLInstallerError 获取关联的 *pfErrorCode 值。 下表列出了 SQLInstallerError 可返回的 *pfErrorCode 值，并说明了此函数上下文中的每个值。

*pfErrorCode 错误 说明
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