The EXCEPTION_RECORD structure describes an exception.
typedef struct _EXCEPTION_RECORD { // exr
DWORD ExceptionCode;
DWORD ExceptionFlags;
struct _EXCEPTION_RECORD *ExceptionRecord;
PVOID ExceptionAddress;
DWORD NumberParameters;
DWORD ExceptionInformation[EXCEPTION_MAXIMUM_PARAMETERS];
} EXCEPTION_RECORD;
Members
ExceptionCode
Specifies the reason the exception occurred. This is the code generated by a hardware exception, or the code specified in the RaiseException function for a software-generated exception. Following are the exception codes likely to occur due to common programming errors:
Value | Meaning | ||||
EXCEPTION_ACCESS_VIOLATION | |||||
The thread tried to read from or write to a virtual address for which it does not have the appropriate access. | |||||
EXCEPTION_ARRAY_BOUNDS_EXCEEDED | |||||
The thread tried to access an array element that is out of bounds and the underlying hardware supports bounds checking. | |||||
EXCEPTION_BREAKPOINT | |||||
A breakpoint was encountered. | |||||
EXCEPTION_DATATYPE_MISALIGNMENT | |||||
The thread tried to read or write data that is misaligned on hardware that does not provide alignment. For example, 16-bit values must be aligned on 2-byte boundaries; 32-bit values on 4-byte boundaries, and so on. | |||||
EXCEPTION_FLT_DENORMAL_OPERAND | |||||
One of the operands in a floating-point operation is denormal. A denormal value is one that is too small to represent as a standard floating-point value. | |||||
EXCEPTION_FLT_DIVIDE_BY_ZERO | |||||
The thread tried to divide a floating-point value by a floating-point divisor of zero. | |||||
EXCEPTION_FLT_INEXACT_RESULT | |||||
The result of a floating-point operation cannot be represented exactly as a decimal fraction. | |||||
EXCEPTION_FLT_INVALID_OPERATION | |||||
This exception represents any floating-point exception not included in this list. | |||||
EXCEPTION_FLT_OVERFLOW | |||||
The exponent of a floating-point operation is greater than the magnitude allowed by the corresponding type. | |||||
EXCEPTION_FLT_STACK_CHECK | |||||
The stack overflowed or underflowed as the result of a floating-point operation. | |||||
EXCEPTION_FLT_UNDERFLOW | |||||
The exponent of a floating-point operation is less than the magnitude allowed by the corresponding type. | |||||
EXCEPTION_ILLEGAL_INSTRUCTION | |||||
The thread tried to execute an invalid instruction. | |||||
EXCEPTION_IN_PAGE_ERROR | |||||
The thread tried to access a page that was not present, and the system was unable to load the page. For example, this exception might occur if a network connection is lost while running a program over the network. | |||||
EXCEPTION_INT_DIVIDE_BY_ZERO | |||||
The thread tried to divide an integer value by an integer divisor of zero. | |||||
EXCEPTION_INT_OVERFLOW | |||||
The result of an integer operation caused a carry out of the most significant bit of the result. | |||||
EXCEPTION_INVALID_DISPOSITION | |||||
An exception handler returned an invalid disposition to the exception dispatcher. Programmers using a high-level language such as C should never encounter this exception. | |||||
EXCEPTION_NONCONTINUABLE_EXCEPTION | |||||
The thread tried to continue execution after a noncontinuable exception occurred. | |||||
EXCEPTION_PRIV_INSTRUCTION | |||||
The thread tried to execute an instruction whose operation is not allowed in the current machine mode. | |||||
EXCEPTION_SINGLE_STEP | |||||
A trace trap or other single-instruction mechanism signaled that one instruction has been executed. | |||||
EXCEPTION_STACK_OVERFLOW | |||||
The thread used up its stack. |
Another exception code is likely to occur when debugging console processes. It does not arise because of a programming error. The DBG_CONTROL_C exception code occurs when CTRL+C is input to a console process that handles CTRL+C signals and is being debugged. This exception code is not meant to be handled by applications. It is raised only for the benefit of the debugger, and is raised only when a debugger is attached to the console process.
ExceptionFlags
Specifies the exception flags. This member can be either zero, indicating a continuable exception, or EXCEPTION_NONCONTINUABLE indicating a noncontinuable exception. Any attempt to continue execution after a noncontinuable exception causes the EXCEPTION_NONCONTINUABLE_EXCEPTION exception.
ExceptionRecord
Points to an associated EXCEPTION_RECORD structure. Exception records can be chained together to provide additional information when nested exceptions occur.
ExceptionAddress
Specifies the address where the exception occurred.
NumberParameters
Specifies the number of parameters associated with the exception. This is the number of defined elements in the ExceptionInformation array.
ExceptionInformation
Specifies an array of additional 32-bit arguments that describe the exception. The RaiseException function can specify this array of arguments. For most exception codes, the array elements are undefined. For the following exception code, the array elements are defined as follows:
Exception code | Array contents | ||||
EXCEPTION_ACCESS_VIOLATION | |||||
The first element of the array contains a read-write flag that indicates the type of operation that caused the access violation. If this value is zero, the thread attempted to read the inaccessible data. If this value is 1, the thread attempted to write to an inaccessible address. | |||||
The second array element specifies the virtual address of the inaccessible data. |
See Also
EXCEPTION_DEBUG_INFO, EXCEPTION_POINTERS, GetExceptionInformation, RaiseException, UnhandledExceptionFilter