IDebugControl3::SetExceptionFilterParameters method (dbgeng.h)

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

Syntax

HRESULT SetExceptionFilterParameters(
  [in] ULONG                              Count,
  [in] PDEBUG_EXCEPTION_FILTER_PARAMETERS Params
);

Parameters

[in] Count

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

[in] 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

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

Return code Description
S_OK
The method was successful.
E_OUTOFMEMORY
The maximum number of arbitrary exception filters

has been exceeded.

Remarks

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

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

GetExceptionFilterParameters

IDebugControl

IDebugControl2

IDebugControl3

SetSpecificFilterParameters

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