共用方式為


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