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

Artigo
02/23/2024

O método SetExceptionFilterParameters altera a status de interrupção e a manipulação status para alguns filtros de exceção.

Sintaxe

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

Parâmetros

[in] Count

Especifica o número de filtros de exceção para os quais alterar os parâmetros.

[in] Params

Especifica uma matriz de parâmetros de filtro de exceção do tipo DEBUG_EXCEPTION_FILTER_PARAMETERS. Somente os campos ExecutionOption, ContinueOption e ExceptionCode desses parâmetros são usados. O campo ExceptionCode é usado para identificar a exceção cujo filtro de exceção será alterado. ExceptionOption especifica o novo status de interrupção e ContinueOption especifica o novo status de tratamento.

Se o valor do campo ExceptionOption for DEBUG_FILTER_REMOVE e o filtro de exceção for um filtro de exceção arbitrário, o filtro de exceção será removido.

Retornar valor

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_OUTOFMEMORY	O número máximo de filtros de exceção arbitrários foi excedido.

Comentários

Para cada um dos parâmetros de filtro de exceção em Parâmetros, se a exceção, identificada pelo código de exceção, já tiver um filtro (específico ou arbitrário), esse filtro será alterado. Caso contrário, um novo filtro de exceção arbitrária será adicionado para a exceção.

Para obter mais informações sobre filtros de evento, consulte Filtros de eventos.