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 |
---|---|
|
The method was successful. |
|
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) |