ODBC 組語教程（二）：連接資料源完整流程與 API 詳解

前言

ODBC 程式透過 ODBC 管理器與驅動程式溝通，連接資料源需經歷：環境控制代碼分配、設定 ODBC 版本、連接控制代碼分配、建立連線、斷線與釋放資源五大階段。

所需引入檔

include windows.inc
include odbc32.inc
includelib odbc32.lib

1. 分配環境控制代碼

.data?
hEnv dd ?
.code
invoke SQLAllocHandle, SQL_HANDLE_ENV, SQL_HANDLE_NULL, addr hEnv
.if ax == SQL_SUCCESS || ax == SQL_SUCCESS_WITH_INFO
    ; 成功
.endif

SQL_HANDLE_NULL 需從 windows.inc 移除尾隨的 "L" 才能通過 MASM 編譯。

2. 設定 ODBC 版本屬性

invoke SQLSetEnvAttr, hEnv, SQL_ATTR_ODBC_VERSION, SQL_OV_ODBC3, NULL
.if ax == SQL_SUCCESS || ax == SQL_SUCCESS_WITH_INFO
    ; 成功
.endif

• SQL_OV_ODBC3：使用 ODBC 3.x 語法（建議）。
• SQL_OV_ODBC2：相容 2.x。

3. 分配連接控制代碼

.data?
hConn dd ?
.code
invoke SQLAllocHandle, SQL_HANDLE_DBC, hEnv, addr hConn

4. 建立連線：三種 API 比較

SQLConnect 範例

.data
DSN db "Sales",0
.code
invoke SQLConnect, hConn, addr DSN, sizeof DSN, 0, 0, 0, 0

SQLDriverConnect 範例

.data
strConnect db "DBQ=c:\data\test.mdb;DRIVER={Microsoft Access Driver (*.mdb)};",0
.data?
buffer db 1024 dup(?)
OutStringLength dd ?
.code
invoke SQLDriverConnect, hConn, hWnd, addr strConnect, sizeof strConnect, \
    addr buffer, sizeof buffer, addr OutStringLength, SQL_DRIVER_COMPLETE

• hWnd：父視窗控制代碼，NULL 則不顯示對話框。
• DriverCompletion：SQL_DRIVER_PROMPT（必詢）、SQL_DRIVER_COMPLETE（缺資訊才詢）、SQL_DRIVER_NOPROMPT（不詢）。

5. 斷線與釋放資源

invoke SQLDisconnect, hConn
invoke SQLFreeHandle, SQL_HANDLE_DBC, hConn
invoke SQLFreeHandle, SQL_HANDLE_ENV, hEnv

SQLFreeHandle 取代舊版 SQLFreeConnect/SQLFreeEnv。

錯誤診斷

所有 ODBC 函數失敗時，可呼叫 SQLGetDiagRec 或 SQLGetDiagField 取得詳細錯誤資訊（類似 GetLastError）。