SQLGetConfigMode 函式

一致性
引進的版本：ODBC 3.0

摘要
SQLGetConfigMode 會擷取組態模式，指出 ODBC.ini 專案清單 DSN 值在系統資訊中的位置。

語法

  
BOOL SQLGetConfigMode(  
     UWORD *   pwConfigMode);  

引數

pwConfigMode
[輸出]包含組態模式之緩衝區的指標。 （請參閱「批註」。）*pwConfigMode 中的 值可以是：

ODBC_USER_DSN

ODBC_SYSTEM_DSN

ODBC_BOTH_DSN

傳回

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

診斷

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

*pfErrorCode	錯誤	描述
ODBC_ERROR_OUT_OF_MEM	記憶體不足	由於記憶體不足，安裝程式無法執行函式。

註解

此函式用來判斷 ODBC.ini 專案清單 DSN 值在系統資訊中的位置。 如果 *pwConfigMode 是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。

根據預設， SQLGetConfigMode 會傳回ODBC_BOTH_DSN。 當 SQLConfigDataSource 呼叫 建立使用者 DSN 或系統 DSN 時，函式會將設定模式設定為ODBC_USER_DSN或ODBC_SYSTEM_DSN，以在修改 DSN 時區分使用者和系統 DSN。 在傳回之前， SQLConfigDataSource 會將組態模式重設為ODBC_BOTH_DSN。

相關函數

如需下列資訊	請參閱
設定組態模式	SQLSetConfigMode