Windows API核心編程：錯誤處理機制詳解

Windows API核心編程：錯誤處理機制詳解

錯誤碼存儲機制：線程本地存儲（TLS）

Windows API函數檢測到錯誤時，不返回錯誤碼，而是將錯誤碼存入調用線程的TLS槽位中。每個線程擁有獨立的錯誤碼空間，互不干擾。

錯誤碼的三種表現形式

1. 消息ID：系統內部標識符
2. 消息文本：人類可讀的描述字符串
3. 錯誤編號：數值代碼（如ERROR_FILE_NOT_FOUND = 2）

核心API函數

1. GetLastError()

獲取調用線程最近一次API調用的錯誤碼。必須緊跟在失敗的API調用之後，任何中間調用都可能覆蓋它。

HANDLE h = CreateFile(...);
if (h == INVALID_HANDLE_VALUE) {
    DWORD err = GetLastError();  // 立即獲取
    // 處理錯誤...
}

2. FormatMessage()

將錯誤碼轉換為本地化描述文本：

LPSTR msgBuf = NULL;
FormatMessage(
    FORMAT_MESSAGE_ALLOCATE_BUFFER | 
    FORMAT_MESSAGE_FROM_SYSTEM |
    FORMAT_MESSAGE_IGNORE_INSERTS,
    NULL, errCode, 
    MAKELANGID(LANG_NEUTRAL, SUBLANG_DEFAULT),
    (LPSTR)&msgBuf, 0, NULL
);
// 使用 msgBuf...
LocalFree(msgBuf);

3. 錯誤查看工具

• Error Lookup（VS附帶）：輸入錯誤碼查看文本
• winerror.h：定義所有錯誤碼常量，路徑通常為C:\Program Files\Microsoft SDKs\Windows\vX.Y\Include\winerror.h

最佳實踐模式

BOOL WinApiCallWithCheck() {
    if (!SomeWinApiFunction()) {
        DWORD err = GetLastError();
        // 1. 記錄錯誤碼 + 文本
        LPSTR msg = NULL;
        FormatMessage(FORMAT_MESSAGE_ALLOCATE_BUFFER | FORMAT_MESSAGE_FROM_SYSTEM,
                     NULL, err, 0, (LPSTR)&msg, 0, NULL);
        LogError("SomeWinApiFunction failed: %lu - %s", err, msg);
        LocalFree(msg);
        // 2. 根據錯誤碼決策：重試、回滾、上報...
        return FALSE;
    }
    return TRUE;
}

常見陷阱

1. 延遲調用GetLastError：中間插入printf、malloc等會重置錯誤碼
2. 忽略成功調用也可能重置錯誤碼：部分API成功時也會清零
3. 跨線程傳遞錯誤碼：TLS隔離，必須在原線程獲取
4. 未檢查返回值直接調用GetLastError：未失敗時值無意義

總結

Windows錯誤處理核心是TLS存儲 + GetLastError獲取 + FormatMessage轉文本。牢記「失敗後立即獲取」，配合錯誤碼查閱工具，能快速定位API調用失敗原因。