SetLastError 函式 (errhandlingapi.h)
設定呼叫執行緒的最後一個錯誤碼。
語法
void SetLastError(
[in] DWORD dwErrCode
);
參數
[in] dwErrCode
執行緒的最後一個錯誤碼。
傳回值
無
備註
最後一個錯誤碼會保留線上程本機儲存體中,讓多個執行緒不會覆寫彼此的值。
大部分的函式只會在失敗時呼叫 SetLastError 或 SetLastErrorEx 。 不過,某些系統函式會在成功的情況下呼叫 SetLastError 或 SetLastErrorEx ;這些案例會在每個函式的檔中加以說明。
應用程式可以選擇性地擷取此函式所設定的值,方法是在函式失敗之後立即使用 GetLastError 函 式。
錯誤碼是 32 位值, (位 31 是最重要的位) 。 位 29 保留給應用程式定義的錯誤碼;沒有系統錯誤碼已設定此位。 如果您要為應用程式定義錯誤碼,請將此位設定為指出錯誤碼已由您的應用程式定義,並確保錯誤碼不會與任何系統定義的錯誤碼衝突。
規格需求
最低支援的用戶端 | Windows XP [傳統型應用程式|UWP 應用程式] |
最低支援的伺服器 | Windows Server 2003 [傳統型應用程式|UWP 應用程式] |
目標平臺 | Windows |
標頭 | errhandlingapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |