|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| -
| Header File
| -
| Unicode
|
| Platform Notes
| None
|
|
|
GetExceptionInformation
The GetExceptionInformation function retrieves a machine-independent description of an exception, and
information about the machine state that existed for the thread when the exception
occurred. This function can be called only from within the filter expression
of a try-except exception handler.
LPEXCEPTION_POINTERS GetExceptionInformation(VOID)
Parameters
This function has no parameters.
Return Values
The return value is a pointer to an EXCEPTION_POINTERS structure that contains pointers to two other structures: an EXCEPTION_RECORD structure containing a description of the exception, and a CONTEXT structure containing the machine-state information.
Remarks
The filter expression (from which the function is called) is evaluated if an
exception occurs during execution of the try block, and it determines whether the except block is executed. The following example shows the structure of a try-except statement.
try {
/* try block */
}
except (filter-expression) {
/* exception handler block */
}
The filter expression can invoke a filter function. The filter function cannot
call GetExceptionInformation. However, the return value of GetExceptionInformation can be passed as a parameter to a filter function.
To pass the EXCEPTION_POINTERS information to the exception-handler block, the filter expression or filter
function must copy the pointer or the data to safe storage that the handler can
later access.
In the case of nested try-except statements, each statement's filter expression is evaluated until one is
evaluated as EXCEPTION_EXECUTE_HANDLER or EXCEPTION_CONTINUE_EXECUTION. Each filter
expression can invoke GetExceptionInformation to get exception information.
See Also
CONTEXT, EXCEPTION_POINTERS, EXCEPTION_RECORD, GetExceptionCode
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
