Método IDebugControl3::SetExceptionFilterParameters (dbgeng.h)

Artículo
02/26/2024

El método SetExceptionFilterParameters cambia el estado de interrupción y el estado de control de algunos filtros de excepción.

Sintaxis

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

Parámetros

[in] Count

Especifica el número de filtros de excepción para los que se van a cambiar los parámetros.

[in] Params

Especifica una matriz de parámetros de filtro de excepciones de tipo DEBUG_EXCEPTION_FILTER_PARAMETERS. Solo se usan los campos ExecutionOption, ContinueOption y ExceptionCode de estos parámetros. El campo ExceptionCode se usa para identificar la excepción cuyo filtro de excepciones se cambiará. ExceptionOption especifica el nuevo estado de interrupción y ContinueOption especifica el nuevo estado de control.

Si el valor del campo ExceptionOption es DEBUG_FILTER_REMOVE y el filtro de excepciones es un filtro de excepción arbitrario, se quitará el filtro de excepciones.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_OUTOFMEMORY	El número máximo de filtros de excepción arbitrarios se ha superado.

Comentarios

Para cada uno de los parámetros de filtro de excepción en Parámetros, si la excepción, identificada por código de excepción, ya tiene un filtro (específico o arbitrario), ese filtro se cambiará. De lo contrario, se agregará un nuevo filtro de excepción arbitrario para la excepción.

Para obtener más información sobre los filtros de eventos, vea Filtros de eventos.