setLastErrorEx 函数 (winuser.h)

设置最后一个错误代码。

目前,此函数与 SetLastError 函数相同。 忽略第二个参数。

语法

void SetLastErrorEx(
  [in] DWORD dwErrCode,
  [in] DWORD dwType
);

参数

[in] dwErrCode

线程的最后一个错误代码。

[in] dwType

忽略此参数。

返回值

备注

最后一个错误代码保存在线程本地存储中,以便多个线程不会覆盖彼此的值。

大多数函数仅在失败时调用 SetLastErrorSetLastErrorEx 。 但是,某些系统函数在成功的情况下调用 SetLastErrorSetLastErrorEx ;每个函数的文档中都记录了这些情况。

应用程序可以选择在函数失败后立即使用 GetLastError 函数检索此函数设置的值。

错误代码是 32 位值(位 31 是最高有效位)。 针对应用程序定义的错误代码会保留位 29,系统错误代码不会设置此位。 如果要为应用程序定义错误代码,请将此位设置为指示错误代码已由应用程序定义,并确保错误代码不与任何系统定义的错误代码冲突。

要求

   
最低受支持的客户端 Windows XP [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 winuser.h (包括 Windows.h)
Library User32.lib
DLL User32.dll

另请参阅

错误处理函数

GetLastError

上一个错误代码