SetLastError

【勇芳软件工作室】汉化HomePreviousNext

SetLastError函数设置调用线程的最后一个错误代码。

VOID SetLastError(

DWORD 【dwErrCode】//每线程错误代码
); 

参数

【dwErrCode】

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

备注

错误代码是32位值(位31是最高有效位)。位29保留用于应用程序定义的错误代码;没有Win32 API错误代码已经设置了这一位。如果要为应用程序定义错误代码,请将此位设置为指示错误代码已由应用程序定义,并确保您的错误代码与任何系统定义的错误代码不冲突。

此函数主要用于动态链接库(DLL)。发生错误后调用此函数可让DLL模拟Win32函数的行为。

大多数Win32函数失败时调用SetLastError.功能故障通常由返回值错误代码(如FALSE,NULL,0xFFFFFFFF或-1)表示。某些功能在成功的条件下调用SetLastError这些情况在每个功能的参考页面中都有说明。

应用程序可以使用GetLastError功能检索此函数保存的值。使用GetLastError是可选的;应用程序可以调用它来找出功能故障的具体原因。

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

也可以看看

GetLastError, SetLastErrorEx, TlsGetValue