WinGetLastError: Difference between revisions

Latest revision as of 14:37, 7 September 2017

Get the error code which was set by the failure of a Presentation Manager function.

Syntax

WinGetLastError(anchorHndl)

Parameters

anchorHndl - HAB - input: The anchor block handle.

Constants

Severity codes defined:

Returns

Returns ERRORID:

The returned error code is a 32-bit value. The high order 16 bits is a severity code. The low order 16 bits is the error code.

Define (C/C++)

INCL_WINERRORS or INCL_PM or INCL_WIN

Calling Convention

Cdecl32

Example Code

HAB     anchorHndl;
ERRORID rc;
...
rc = WinGetLastError(anchorHndl);
...

Related Functions

Notes

This call retrieves the last error code and resets it to zero.

In multiple threaded applications where there are multiple anchor blocks, errors are stored in the anchor block created by the WinInitialize function of the thread invoking a call. The last error for the process and thread on which this function call is made will be returned.

@@ Line 1: / Line 1: @@
-== WinGetLastError ==
-; WinGetLastError(anchorHndl) :
 Get the error code which was set by the failure of a Presentation Manager function.
+==Syntax==
+ WinGetLastError(anchorHndl)
 === Parameters ===
-; anchorHndl - [[OS2_API:DataType:HAB|HAB]] - input :
+;anchorHndl - [[HAB]] - input : The anchor block handle.
-The anchor block handle.
 === Constants ===
 Severity codes defined:
-* [[OS2 API:Constant:SEVERITY#SEVERITY_NOERROR|SEVERITY_NOERROR]]
+*[[SEVERITY#SEVERITY_NOERROR|SEVERITY_NOERROR]]
-* [[OS2 API:Constant:SEVERITY#SEVERITY_WARNING|SEVERITY_WARNING]]
+*[[SEVERITY#SEVERITY_WARNING|SEVERITY_WARNING]]
-* [[OS2 API:Constant:SEVERITY#SEVERITY_ERROR|SEVERITY_ERROR]]
+*[[SEVERITY#SEVERITY_ERROR|SEVERITY_ERROR]]
-* [[OS2 API:Constant:SEVERITY#SEVERITY_SEVERE|SEVERITY_SEVERE]]
+*[[SEVERITY#SEVERITY_SEVERE|SEVERITY_SEVERE]]
-* [[OS2 API:Constant:SEVERITY#SEVERITY_UNRECOVERABLE|SEVERITY_UNRECOVERABLE]]
+*[[SEVERITY#SEVERITY_UNRECOVERABLE|SEVERITY_UNRECOVERABLE]]
 === Returns ===
-Returns [[OS2_API:DataType:ERRORID|ERRORID]]:
+Returns [[ERRORID]]:
 The returned error code is a 32-bit value. The high order 16 bits is a severity code. The low order 16 bits is the error code.
-=== Module ===
 === Define (C/C++) ===
 INCL_WINERRORS or INCL_PM or INCL_WIN
-=== Export name/Ordinal ===
+=== Calling Convention ===
-=== Calling conversion ===
 [[Cdecl32]]
 === Example Code ===
-  [[OS2 API:DataType:HAB|HAB]]     anchorHndl;
+  HAB     anchorHndl;
-  [[OS2 API:DataType:ERRORID|ERRORID]] rc;
+  ERRORID rc;
   ...
   rc = WinGetLastError(anchorHndl);
@@ Line 38: / Line 33: @@
 === Related Functions ===
-[[OS2 API:WinFreeErrorInfo|WinFreeErrorInfo]] [[OS2 API:WinGetErrorInfo|WinGetErrorInfo]]
+*[[WinFreeErrorInfo]]
+*[[WinGetErrorInfo]]
 === Notes ===
 This call retrieves the last error code and resets it to zero.
-In multiple threaded applications where there are multiple anchor blocks, errors are stored in the anchor block created by the [[OS2_API:WinInitialize|WinInitialize]] function of the thread invoking a call. The last error for the process and thread on which this function call is made will be returned.
+In multiple threaded applications where there are multiple anchor blocks, errors are stored in the anchor block created by the [[WinInitialize]] function of the thread invoking a call. The last error for the process and thread on which this function call is made will be returned.
-=== OS Version Introduced ===
+[[Category:Win]]