GetLastError

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

GetLastError函数返回调用线程的最后一个错误代码值。最后一个错误代码基于每个线程进行维护。多个线程不会覆盖彼此的最后一个错误代码。

DWORD GetLastError(VOID)

参数

此函数无参数。

返回值

返回值是调用线程的最后一个错误代码值。函数通过调用SetLastError功能设置此值。每个参考页面的回报值部分说明了功能设置最后一个错误代码的条件。

备注

当函数的返回值表示此类调用将返回有用数据时,您应立即调用GetLastError函数。这是因为某些功能在成功时调用SetLastError(0),擦除由最近失败的函数设置的错误代码。

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

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

要获取操作系统错误代码的错误字符串,请使用FormatMessage功能。有关错误代码的完整列表,请参阅Win32 SDK中的WINNT.H头文件。

也可以看看

FormatMessage, SetLastError, SetLastErrorEx