SetExceptionFilterParameters

The SetExceptionFilterParameters method changes the break status and handling status for some exception filters.

HRESULT
  IDebugControl::SetExceptionFilterParameters(
    IN ULONG  Count,
    IN DEBUG_EXCEPTION_FILTER_PARAMETERS *  Params
    );

Parameters

Count

Specifies the number of exception filters to change the parameters for.

Params

Specifies an array of exception filter parameters of type DEBUG_EXCEPTION_FILTER_PARAMETERS. Only the ExecutionOption, ContinueOption, and ExceptionCode fields of these parameters are used. The ExceptionCode field is used to identify the exception whose exception filter will be changed. ExceptionOption specifies the new break status and ContinueOption specifies the new handling status.

If the value of the ExceptionOption field is DEBUG_FILTER_REMOVE and the exception filter is an arbitrary exception filter, the exception filter will be removed.

Return Value

S_OK

The method was successful.

E_OUTOFMEMORY

The maximum number of arbitrary exception filters has been exceeded.

This method may also return error values. See Return Values for more details.

Interface Version

SetExceptionFilterParameters is available in all versions of IDebugControl.

Comments

For each of the exception filter parameters in Params, if the exception, identified by exception code, already has a filter (specific or arbitrary), that filter will be changed. Otherwise, a new arbitrary exception filter will be added for the exception.

For more information about event filters, see Event Filters.

Requirements

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

sx, sxd, sxe, sxi, sxn (Set Exceptions), GetExceptionFilterParameters, SetSpecificFilterParameters