SQLManageDataSources

一致性
引進的版本：ODBC 2.0

摘要
SQLManageDataSources 會顯示對話方塊，讓使用者可以在系統資訊中設定、新增和刪除數據源。

語法

  
BOOL SQLManageDataSources(  
     HWND     hwnd);  

參數

hwnd
[輸入]父視窗句柄。

返回

如果 hwnd 不是有效的視窗句柄，SQLManageDataSources 會傳回 FALSE。 否則會傳回 TRUE。

診斷

SQLManageDataSources 傳回 FALSE 時，呼叫 sqlInstallerError，即可取得相關聯的 *pfErrorCode 值。 下表列出 *pfErrorCode 值，這些值可由 SQLInstallerError 傳回，並說明此函式內容中的每個值。

*pfErrorCode	錯誤	描述
ODBC_ERROR_GENERAL_ERR	一般安裝程序錯誤	發生錯誤，沒有特定的安裝程序錯誤。
ODBC_ERROR_REQUEST_FAILED	要求 失敗	ConfigDSN 呼叫失敗。
ODBC_ERROR_INVALID__HWND	無效的視窗句柄	hwnd 自變數無效或 NULL。
ODBC_ERROR_OUT_OF_MEM	記憶體不足	由於記憶體不足，安裝程式無法執行函式。

管理數據源

SQLManageDataSources 一開始會顯示 [ODBC 數據源管理員] 對話框，如下圖所示。

對話框會顯示三個索引標籤系統資訊中所列的數據來源：User DSN、System DSN，以及 File DSN。 如果使用者按兩下資料源或選取資料源，然後按兩下 [設定]，SQLManageDataSources 會使用 ODBC_CONFIG_DSN 選項在設定 DLL 中呼叫 ConfigDSN。

如果使用者按兩下 [新增] ，SQLManageDataSources 會顯示 [建立新的數據源] 對話框 ，如下圖所示。

對話框會顯示已安裝的驅動程式清單。 如果使用者按兩下驅動程式，或選取驅動程式，然後按兩下 [確定]，SQLManageDataSources 在安裝 DLL 中呼叫 ConfigDSN，並將它傳遞ODBC_ADD_DSN選項。

如果使用者選取數據源，然後按兩下 [移除] ，SQLManageDataSources 詢問使用者是否要刪除數據源。 如果使用者按兩下 [是]，SQLManageDataSources 會使用 [ODBC_REMOVE_DSN] 選項在安裝 DLL 中呼叫 ConfigDSN。

[建立新的數據源] 對話框 用來新增或刪除使用者數據源、系統數據源或檔案數據源。

使用者 DSN

為個別使用者建立的 DSN 將會稱為使用者 DSN，以區別它們與系統 DSN。 使用者 DSN 會在系統資訊中註冊如下：

HKEY_CURRENT_USERS

SOFTWARE

ODBC

Odbc.ini

系統 DSN

[建立新的數據源] 對話框 可讓您將系統數據源新增至本機計算機或刪除數據源，或設定系統數據源的組態。

使用系統數據來源名稱 （DSN） 設定的數據源，可以由同一部電腦上的多個使用者使用。 它也可以由全系統服務使用，即使沒有使用者登入計算機，也可以存取數據源。

系統 DSN 會在系統資訊中的HKEY_LOCAL_MACHINE項目中註冊，而不是在HKEY_CURRENT_USER項目中註冊。 它不會繫結至一位使用其特定使用者名稱和密碼登入的使用者，但可由該計算機的任何使用者或自動全系統服務使用。 不過，系統 DSN 會系結至一部電腦。 它不支援在機器之間使用遠端 DSN 的功能。 系統會在系統資訊中註冊系統 DSN，如下所示：

HKEY_LOCAL_MACHINE SOFTWARE ODBC Odbc.ini

檔案 DSN

檔案數據源沒有數據源名稱，計算機數據源也一樣，而且不會向任何一位使用者或計算機註冊。 該數據源的連接資訊包含在可複製到任何計算機的 .dsn 檔案中。 檔案數據源可以共用，在此情況下，.dsn 檔案位於網路上，只要使用者已安裝適當的驅動程式，就可以同時供網路上的多個使用者使用。 檔案數據源也可以無法共用，在此情況下，它只能用於單一計算機上。

如需檔案資料源的詳細資訊，請參閱使用檔案數據源連接，或請參閱 SQLDriverConnect。

管理驅動程式

如果使用者在 [ODBC 數據源管理員] 對話框中按兩下 [驅動程式] 索引標籤，SQLManageDataSources 會顯示系統上已安裝的 ODBC 驅動程式清單，以及驅動程式的相關信息。 顯示的日期是驅動程式的建立日期，如下圖所示。

追蹤選項

如果使用者按兩下 [ODBC 數據源管理員] 對話方塊中的 [追蹤] 索引標籤，SQLManageDataSources 會顯示追蹤選項，如下圖所示。

如果使用者按兩下 [立即啟動追蹤] 然後按兩下 [確定]，SQLManageDataSources 會手動啟用電腦上所有執行之應用程式的追蹤。

如果使用者在 [記錄檔路徑] 文本框中指定追蹤檔案的名稱，然後按兩下 [確定]，SQLManageDataSources 會將系統資訊 [ODBC] 區段中的 [ODBC] 區段中的 TraceFile 關鍵詞設定為指定的名稱。

重要

從 Windows 8 開始，已移除 Visual Studio Analyzer 的支援（Visual Studio Analyzer 僅包含在舊版 Visual Studio 中。 如需替代的疑難解答機制，請使用 BID 追蹤。

如果使用者按兩下 啟動 Visual Studio Analyzer，然後按兩下 [確定]，則會啟用 Visual Studio Analyzer。 在單擊 [停止 Visual Studio 分析器] 之前，它仍會保持啟用狀態。

如需追蹤的詳細資訊，請參閱 追蹤。 如需 追蹤 和 TraceFile 關鍵詞的詳細資訊，請參閱 odbc 子機碼。

相關函式

如需相關信息	看
建立數據源	SQLCreateDataSource