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

Artigo
02/23/2024

O método GetExceptionFilterSecondCommand retorna o comando que será executado pelo mecanismo de depurador após a segunda chance de uma exceção especificada.

Sintaxe

HRESULT GetExceptionFilterSecondCommand(
  [in]            ULONG  Index,
  [out, optional] PSTR   Buffer,
  [in]            ULONG  BufferSize,
  [out, optional] PULONG CommandSize
);

Parâmetros

[in] Index

Especifica o índice do filtro de exceção cujo comando de segunda chance será retornado. O índice também pode se referir ao filtro de exceção padrão para retornar o comando de segunda chance para as exceções que não têm um filtro de exceção específico ou arbitrário.

[out, optional] Buffer

Recebe o comando de segunda chance para o filtro de exceção.

[in] BufferSize

Especifica o tamanho, em caracteres, do buffer especificado pelo Buffer . Esse tamanho inclui o espaço para o caractere de terminação '\0'.

[out, optional] CommandSize

Recebe o tamanho, em caracteres, do comando de segunda chance para o filtro de exceção. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se CommandSize for NULL, essas informações não serão retornadas.

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.

Comentários

Somente filtros de exceção dão suporte a um comando de segunda chance. Se Index se referir a um filtro de evento específico, o comando retornado ao Buffer ficará vazio. O comando retornado também estará vazio se nenhum comando de segunda chance tiver sido definido para a exceção especificada.

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