驅動程式規格子機碼
ODBC 驅動程式子機碼列出的每個驅動程式都有自己的子機碼。 此子機碼的名稱與 ODBC 驅動程式子機碼的對應值相同。 此子機碼的值列出驅動程式及驅動程式設定 DLL 的完整路徑、SQLDrivers 傳回的驅動程式關鍵字值，以及使用計數。 數值的格式如下表所示。
| 名稱 | 資料類型 | 資料 |
|---|---|---|
| API Level | REG_SZ | 0 | 1 | 2 |
| ConnectFunctions | REG_SZ | {Y|N}{Y|N}{Y|N} |
| Create DSN | REG_SZ | 驅動程式-描述 |
| 驅動程式 | REG_SZ | 驅動程式-DLL-路徑 |
| DriverODBCVer | REG_SZ | nn.nn |
| FileExtns | REG_SZ | *. file-extension1[,*. file-extension2]... |
| 檔案使用方法 | REG_SZ | 0 | 1 | 2 |
| 設定 | REG_SZ | 集合-DLL-路徑 |
| 結構化查詢語言 (SQL) 等級 | REG_SZ | 0 | 1 | 2 |
| UsageCount | REG_DWORD | 計數 |
下表呈現每個關鍵字的使用方式。
| 關鍵字 | 使用方式 |
|---|---|
| API Level | 指出驅動程式支援的 ODBC 介面一致性層級的數字： 0 = 無 1 = 層級 1 支援 2 = 層級 2 支援 這必須與 SQLGetInfo 的 SQL_ODBC_INTERFACE_CONFORMANCE 選項傳回的值相同。 |
| Create DSN | 安裝驅動程式時需要建立的一或多個資料來源名稱。 以 CreateDSN 關鍵字列出的每個資料來源，系統資訊必須包含一個資料來源規格區段。 這些區段不應包含 Driver 關鍵字，因為這是在驅動程式規格區段所指定，但必須包含驅動程式設定 DLL ConfigDSN 函式足夠的資訊，才能建立資料來源規格，而不顯示任何對話方塊。 如需資料來源規格區段的格式，請參閱資料來源規格子機碼。 |
| 連線功能 | 一個三字元字串，指出驅動程式是否支援 SQLConnect、SQLDriverConnect 以及 SQLBrowseConnect。 如果驅動程式支援 SQLConnect，則第一個字元為「Y」；否則為「N」。 如果驅動程式支援 SQLDriverConnect，則第二個字元為「Y」；否則為「N」。 如果驅動程式支援 SQLBrowseConnect，則第三個字元為「Y」；否則為「N」。 例如，如果驅動程式支援 SQLConnect 及 SQLDriverConnect，但不支援 SQLBrowseConnect，則三個字元字串為「YYN」。 |
| DriverODBCVer | 具有驅動程式支援 ODBC 版本的字元字串。 版本的格式為 nn.nn，其中前兩位數字是主要版本，而後兩位數字則是次要版本。 針對本手冊所述的 ODBC 版本，驅動程式必須傳回 「03.00」。 這必須與為 SQLGetInfo 的 SQL_DRIVER_ODBC_VER 選項傳回的值相同。 |
| FileExtns | 針對檔案型驅動程式，驅動程式可使用的副檔名的逗號分隔清單。 例如，dBASE 驅動程式可能會指定 *.dbf，而格式化的文字檔驅動程式可能會指定 *.txt、*.csv。 如需應用程式如何使用這項資訊的範例，請參閱 檔案使用方法 關鍵字。 |
| 檔案使用方法 | 指出檔案型驅動程式如何直接處理資料來源的檔案的數字。 0 = 此驅動程式不是檔案型驅動程式。 例如，ORACLE 驅動程式是一個以 DBMS 為基礎的驅動程式。 1 = 檔案型驅動程式會將資料來源的檔案作為資料表。 例如，Xbase 驅動程式會將每個 Xbase 檔案作為資料表。 2 = 檔案型驅動程式會將資料來源的檔案視為目錄。 例如，Microsoft Access 驅動程式將每個 Microsoft Access 檔案視為完整的資料庫。 應用程式可能會使用此方式來判斷使用者將如何選取資料。 例如，Xbase 及 Paradox 使用者通常認為資料儲存在檔案，而 ORACLE 與 Microsoft Access 使用者則通常認為資料儲存在資料表。 當使用者從 [檔案] 功能表選取 [開啟資料檔案] 時，應用程式可能會顯示 [Windows 檔案開啟] 通用對話方塊。 檔案類型清單會針對指定 FileUsage 值為 1 及「Y」的驅動程式使用 FileExtns 關鍵字所指定的副檔名，做為 ConnectFunctions 關鍵字值的第二個字元。 使用者選取檔案之後，應用程式將使用 DRIVER 關鍵字呼叫 SQLDriverConnect，然後執行 SELECT * FROM table-name 陳述式。 當使用者從 [檔案] 功能表選取 [匯入資料] 時，應用程式可能會顯示驅動程式描述清單，這些驅動程式將 FileUsage 值指定為 0 或 2，並將「Y」指定為 ConnectFunctions 關鍵字值的第二個字元。 使用者選取驅動程式之後，應用程式將使用 DRIVER 關鍵字呼叫 SQLDriverConnect，然後顯示自訂的 [選取資料表] 對話方塊。 |
| SQL 等級 | 指出驅動程式支援的 SQL-92 文法的數字： 0 = SQL-92 入門級別 1 = FIPS127-2 過度版本 2 = SQL-92 中等版本 3 = SQL-92 完整版 這必須與 SQLGetInfo 的 SQL_SQL_CONFORMANCE選項傳回的值相同。 |
如需使用量計數的詳細資訊，請參閱本節先前討論的使用量計數。
應用程式不應設定使用量計數。 ODBC 會維持此計數。
例如，假設格式化文字檔的驅動程式具有名為 Text.dll 的驅動程式 DLL、名為 Txtsetup.dll 的個別驅動程式安裝 DLL，並已安裝三次。 如果驅動程式支援第 1 級 API 一致性層級，支援最低 SQL 文法一致性層級、將檔案視為資料表，且可使用具有 .txt 及 .csv 副檔名的檔案，則文字子機碼值可能如下所示：
APILevel : REG_SZ : 1
ConnectFunctions : REG_SZ : YYN
Driver : REG_SZ : C:\WINDOWS\SYSTEM32\TEXT.DLL
DriverODBCVer : REG_SZ : 03.00.00
FileExtns : REG_SZ : *.txt,*.csv
FileUsage : REG_SZ : 1
Setup : REG_SZ : C:\WINDOWS\SYSTEM32\TXTSETUP.DLL
SQLLevel : REG_SZ : 0
UsageCount : REG_DWORD : 0x3