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