共用方式為


SQLSetConfigMode 函式

一致性
引進的版本:ODBC 3.0

摘要
SQLSetConfigMode 會設定組態模式,指出 ODBC.ini 專案清單 DSN 值在系統資訊中的位置。

語法

  
BOOL SQLSetConfigMode(  
     UWORD     wConfigMode);  

引數

wConfigMode
[輸入]安裝程式設定模式(請參閱。 wConfigMode 中的 值可以是:

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

傳回

如果函式成功,則傳回 TRUE,如果失敗,則傳回 FALSE。

診斷

當 SQLSetConfigMode 傳回 FALSE 時 ,可以呼叫 SQLInstallerError 來取得相關聯的 *pfErrorCode 值。 下表列出 SQLInstallerError 可傳 回的 *pfErrorCode 值,並說明此函式內容中的每個值。

*pfErrorCode 錯誤 描述
ODBC_ERROR_INVALID_PARAM_SEQUENCE 不正確參數序列 wConfigMode 引數不包含ODBC_USER_DSN、ODBC_SYSTEM_DSN或ODBC_BOTH_DSN。

註解

此函式可用來設定 ODBC.ini 專案清單 DSN 值在系統資訊中的位置。 如果 wConfigMode 是ODBC_USER_DSN,DSN 是 User DSN,且函式會從 HKEY_CURRENT_USER 的 Odbc.ini 專案讀取。 如果ODBC_SYSTEM_DSN,DSN 是 System DSN,且函式會從 HKEY_LOCAL_MACHINE 的 Odbc.ini 專案讀取。 如果ODBC_BOTH_DSN,則會嘗試HKEY_CURRENT_USER,如果失敗,則會使用HKEY_LOCAL_MACHINE。

此函式不會影響 SQLCreateDataSource SQLDriverConnect 。 當驅動程式呼叫 SQLGetPrivateProfileString 或呼叫 SQLWritePrivateProfileString 寫入登錄時,必須設定組態模式。 呼叫 SQLGetPrivateProfileString SQLWritePrivateProfileString 會使用組態模式來知道登錄的哪個部分運作。

警告

SQLSetConfigMode 應該只在必要時呼叫;如果設定模式不正確,ODBC 安裝程式可能無法正常運作。

SQLSetConfigMode 會直接修改組態模式。 這與呼叫 SQLConfigDataSource 修改組態模式的程式不同。 對 SQLConfigDataSource 呼叫會設定設定模式,以在修改 DSN 時區分使用者和系統 DSN。 在傳回之前, SQLConfigDataSource 會將設定模式重設為 BOTHDSN。

如需下列資訊 請參閱
建立資料來源 SQLCreateDataSource
使用連接字串或對話方塊連接到資料來源 SQLDriverConnect
擷取組態模式 SQLGetConfigMode