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