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) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |