IDebugControl::SetExceptionFilterParameters method (dbgeng.h)

Article
02/22/2024

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)