INtime SDK Help
RaiseException
INtime SDK v7 > About INtime > INtime Kernel > Exception handling > RaiseException

Part of the Structured Exception Handling set of functions, this function raises an exception in the calling thread.

void RaiseException(
    DWORD dwExceptionCode,
    DWORD dwExceptionFlags,
    DWORD nNumberOfArguments,
    const ULONG_PTR* lpArguments
);

Parameters

dwExceptionCode
[in] Application-defined exception code of the exception being raised. The filter expression and exception-handler block of an exception handler can use GetExceptionCode to retrieve this value.
dwExceptionFlags
The exception flags. This can be either zero to indicate a continuable exception, or EXCEPTION_NONCONTINUABLE to indicate a noncontinuable exception. Any attempt to continue execution after a noncontinuable exception causes the EXCEPTION_NONCONTINUABLE_EXCEPTION exception.
nNumberOfArguments
The number of arguments in the lpArguments array. This value must not exceed EXCEPTION_MAXIMUM_PARAMETERS. This parameter is ignored if lpArguments is NULL.
lpArguments
An array of arguments. This parameter can be NULL. These arguments can contain any application-defined data that needs to be passed to the filter expression of the exception handler.

Remarks

The RaiseException function enables a process to use structured exception handling to handle private, software-generated, application-defined exceptions.

The values specified in the dwExceptionCode, dwExceptionFlags, nNumberOfArguments, and lpArguments parameters can be retrieved in the filter expression of a frame-based exception handler by calling the GetExceptionInformation.

Return Values

This function does not return a value.

Requirements

Versions Defined in Include Link to
INtime 3.0 intime/rt/include/rtexcpt.h rt.h rt.lib

Note

This function operates in the real-time portion of your application.

See Also

Exception handling, GetExceptionCode