SetLastError

原文链接 -> 传送门

函数功能：

SetLastError 函数用于为调用线程设置最近的错误代码。


API 函数原型：

注释：_In_ 说明该参数是输入的。

void WINAPI SetLastError(
  _In_ DWORD dwErrCode
);

参数解析：
 

返回值：

该函数没有返回值。


备注：

1. 最近错误代码保存在线程局部空间中，所以多线程不会互相覆盖其它线程的值。

2. 大多数函数仅在失败时调用 SetLastError 或 SetLastErrorEx 函数。然而一些系统函数在成功的情况下也会调用 SetLastError 或 SetLastErrorEx 函数；这些情况在这些函数的文档中都有记录。

3. 应用程序能可选择地在函数失败后立刻通过调用 GetLastError 函数来获取通过 SetLastError 函数设置的值。

4. 错误代码是 32 位值（但第 31 位是最重要的位），第 29 位为应用程序定义的错误代码保留；系统错误代码不会将该位置位。如果你为你的应用程序定义了一个错误代码，则将该位置位来表明错误代码已经被你的应用程序定义，并保证你的错误代码不会与系统定义的错误代码相冲突。


需求：