適用於：
SQL ServerAzure SQL DatabaseAzure SQL 受控實例
安裝程式 DLL API 提供 ODBC 資料來源、驅動程式與轉譯器的程式化管理功能。 應用程式與設定程式會利用這些功能安裝、設定及移除 ODBC 元件，並管理登錄檔資訊。 Microsoft 負責撰寫並重新分發安裝程式 DLL。
API 包含 25 個函式。 其中三個函數 SQLGetTranslator、 SQLRemoveDSNFromIni、 SQLWriteDSNToIni、 僅由設置 DLL 呼叫。 設定與管理程式呼叫其他功能。
每個函式都會標示其引入的 ODBC 版本。
資料來源配置
這些函式以程式化方式建立、修改及移除 ODBC 資料來源。 在建置需要在使用者不互動的情況下配置資料來源連線的自訂設定程式或應用程式時，使用它們。
| 功能 | Description |
|---|---|
| SQLConfigDataSource | 新增、修改或刪除資料來源。 呼叫驅動程式設定 DLL 來執行實際設定。 |
| SQLCreateDataSource | 顯示一個對話框，讓使用者能互動式地新增資料來源。 |
| SQLManageDataSources | 顯示一個用於管理資料來源與追蹤選項的對話框，類似於 ODBC 資料來源管理員。 |
| SQLValidDSN | 在資料來源名稱寫入登錄檔前，檢查其長度與有效性。 |
| SQLReadFileDSN | 從檔案資料來源名稱（.dsn 檔案）讀取連線資訊。 |
| SQLWriteFileDSN | 將連線資訊寫入基於檔案的資料來源名稱（.dsn 檔案）。 |
| SQLRemoveDefaultDataSource | 移除系統資訊中的預設資料來源。 |
驅動程式安裝與移除
這些功能安裝並移除系統中的 ODBC 驅動程式。 它們管理登錄檔條目和使用次數，以支援多個共用相同驅動程式的應用程式。
| 功能 | Description |
|---|---|
| SQLInstallDriverEx | 將驅動程式資訊加入登錄檔並增加驅動程式的使用次數。 回傳驅動程式檔案的目標目錄。 |
| SQLInstallDriverManager | 回傳安裝 ODBC 核心元件的目標目錄。 在 ODBC 3.0 中被棄用，因為驅動程式管理器是 Windows 的一部分。 |
| SQLRemoveDriver | 從登記資料中移除駕駛資訊。 當使用次數歸零時，會減少驅動程式的使用次數，並移除登錄檔項目。 |
| SQLRemoveDriverManager | 減少 ODBC 核心元件的使用次數。 被棄用是因為驅動程式管理員現在是 Windows 的一部分。 |
| SQLConfigDriver | 載入驅動程式的設定 DLL 並呼叫其 ConfigDriver 函式以執行驅動程式專屬的設定任務。 |
轉播器安裝與拆除
這些函式管理 ODBC 轉譯器，該轉換器在字元集間轉換資料（例如 ANSI 轉 Unicode）。 當你的應用程式在與資料來源通訊時需要資料轉換時，才會使用它們。
| 功能 | Description |
|---|---|
| SQLInstallTranslatorEx | 將譯者資訊加入登錄檔，並增加譯者使用次數。 |
| SQLInstallTranslator | 安裝翻譯器。 被淘汰; SQLInstallTranslatorEx 用吧。 |
| SQLRemoveTranslator | 從登錄檔中移除翻譯者資訊。 減少使用次數，並在使用次數歸零時移除條目。 |
| SQLGetTranslator | 顯示一個對話框，用於選擇翻譯器。 由驅動程式呼叫，設定 DLL 來提示使用者選擇翻譯器。 |
登錄與設定工具
這些函式在 Windows 登錄檔的 ODBC 區段讀寫設定資料。 其他安裝程式功能和驅動程式設定 DLL 內部也會用到它們。
| 功能 | Description |
|---|---|
| SQLWriteDSNToIni | 在登錄檔中新增一個資料來源名稱。 驅動程式在建立新資料來源時會呼叫設定 DLL。 |
| SQLRemoveDSNFromIni | 從登錄檔中移除資料來源名稱。 這是驅動程式在刪除資料來源時設定的 DLL 呼叫的。 |
| SQLGetPrivateProfileString | 讀取登錄檔中資料來源規格子鍵的值。 |
| SQLWritePrivateProfileString | 在登錄檔中寫入資料來源規格子鍵的值。 |
| SQLGetInstalledDrivers | 從登錄檔回傳已安裝的 ODBC 驅動程式清單。 |
| SQLGetConfigMode | 擷取指示資料來源條目使用哪個登錄檔位置（使用者或系統）的設定模式。 |
| SQLSetConfigMode | 設定設定模式，指示登錄檔中資料來源條目寫入的位置。 |
錯誤處理
當安裝程式功能失效時，這些函式會提供錯誤資訊。
| 功能 | Description |
|---|---|
| SQLInstallerError | 回傳安裝程式功能的錯誤或狀態資訊。 安裝程式 DLL 中的每個函式都會顯示零個或多個錯誤，這些錯誤可由此函式檢索。 |
| SQLPostInstallerError | 讓驅動程式設定的 DLL 能向安裝程式錯誤佇列回報錯誤，讓 SQLInstallerError 安裝程式能回傳錯誤。 |