AppBuilder/VC 直接呼叫 ODBC API 存取資料庫完整指南

不使用 MFC CDatabase/CRecordset 封裝層，直接呼叫 ODBC 核心 API (SQLAllocEnv、SQLConnect、SQLExecDirect 等) 實現資料庫操作，適用於需要精細控制或非 MFC 專案。

第一章：DSN 設定 (控制台)

1. 開啟「控制台」→「ODBC 資料來源」(32 位/64 位對應應用程式位數)。
2. 「使用者 DSN」頁籤 →「新增」→ 選擇驅動程式 (如 Microsoft Access Driver (*.mdb)) → 設定 DSN 名稱、資料庫檔案路徑。

第二章：ODBC 核心 API 程式設計流程

1. 環境與連線建立

SQLHENV hEnv = SQL_NULL_HENV;
SQLHDBC hDbc = SQL_NULL_HDBC;
SQLRETURN ret;

// 分配環境控制代碼
ret = SQLAllocEnv(&hEnv);
if (ret != SQL_SUCCESS) return FALSE;

// 分配連線控制代碼
ret = SQLAllocConnect(hEnv, &hDbc);
if (ret != SQL_SUCCESS) return FALSE;

// 連線資料來源 (DSN 名稱)
ret = SQLConnect(hDbc, (SQLCHAR*)szDSN, SQL_NTS, NULL, 0, NULL, 0);
if (ret == SQL_SUCCESS || ret == SQL_SUCCESS_WITH_INFO) {
    // 連線成功
}

2. 執行 SQL 與綁定結果集

SQLHSTMT hStmt;
SQLAllocHandle(SQL_HANDLE_STMT, hDbc, &hStmt);

CString strSQL = "SELECT NID, ARIQI, NJINE, ASHUOMING ... FROM HHZhiChu WHERE NID = ?";
// 參數化查詢建議使用 SQLBindParameter + SQLExecute
// 簡易版直接拼裝字串:
strSQL.Format(_T("SELECT ... FROM HHZhiChu WHERE NID=%u"), nID);

ret = SQLExecDirect(hStmt, (SQLCHAR*)(LPCTSTR)strSQL, SQL_NTS);
if (ret == SQL_SUCCESS) {
    // 綁定欄位至變數
    SQLBindCol(hStmt, 1, SQL_C_SLONG, &dbData.m_NID, 0, &cb);
    SQLBindCol(hStmt, 2, SQL_C_TIMESTAMP, &dbData.m_ARIQI, 0, &cb);
    SQLBindCol(hStmt, 3, SQL_C_DOUBLE, &dbData.m_NJINE, 0, &cb);
    SQLBindCol(hStmt, 4, SQL_C_CHAR, dbData.m_ASHUOMING, SIZE, &cb);
    // ... 其他欄位 ...

    // 擷取單筆資料
    if (SQLFetch(hStmt) == SQL_SUCCESS) {
        // dbData 已填入資料，可直接使用
    }
}
SQLFreeHandle(SQL_HANDLE_STMT, hStmt);

3. 斷線與資源釋放

if (bConnected) {
    SQLDisconnect(hDbc);
    SQLFreeHandle(SQL_HANDLE_DBC, hDbc); hDbc = SQL_NULL_HDBC;
}
if (hEnv) {
    SQLFreeHandle(SQL_HANDLE_ENV, hEnv); hEnv = SQL_NULL_HENV;
}
// 可選：移除臨時 DSN
SQLConfigDataSource(NULL, ODBC_REMOVE_DSN, driver, szAttr);

進階操作：Access 專用功能

錯誤處理模式

SQLCHAR szSqlState[6], szMsg[256];
SQLINTEGER nErr;
SQLSMALLINT nMsgLen;
SQLError(hEnv, hDbc, hStmt, szSqlState, &nErr, szMsg, 255, &nMsgLen);
// szSqlState 為標準 SQLSTATE 代碼 (如 08001 連線失敗)

建議： 新專案優先考慮 ODBC 3.5+ 模式 (SQLAllocHandle 取代 SQLAllocEnv/Connect)、參數化查詢 (SQLBindParameter + SQLExecute) 防止 SQL 注入、連線池管理。本文展示核心流程以利理解底層機制。