Метод IDebugControl3::SetExceptionFilterParameters (dbgeng.h)

Статья
08/07/2023

Метод SetExceptionFilterParameters изменяет состояние останова и состояние обработки для некоторых фильтров исключений.

Синтаксис

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

Параметры

[in] Count

Указывает количество фильтров исключений, для которых необходимо изменить параметры.

[in] Params

Задает массив параметров фильтра исключений типа DEBUG_EXCEPTION_FILTER_PARAMETERS. Используются только поля ExecutionOption, ContinueOption и ExceptionCode этих параметров. Поле ExceptionCode используется для определения исключения , фильтр исключений которого будет изменен. ExceptionOption указывает новое состояние останова, а ContinueOption — новое состояние обработки.

Если значение поля ExceptionOption равно DEBUG_FILTER_REMOVE, а фильтр исключений является произвольным, фильтр исключений будет удален.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_OUTOFMEMORY	Максимальное число произвольных фильтров исключений превышено.

Для каждого из параметров фильтра исключений в Params, если исключение, определенное кодом исключения, уже имеет фильтр (определенный или произвольный), этот фильтр будет изменен. В противном случае для исключения будет добавлен новый произвольный фильтр исключений.

Дополнительные сведения о фильтрах событий см. в разделе Фильтры событий.