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 |