Compartilhar via


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

O método GetEventFilterCommand retorna o comando de depurador que o mecanismo executará quando ocorrer um evento especificado.

Sintaxe

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

Parâmetros

[in] Index

Especifica o índice do filtro de evento. O índice pode obter qualquer valor entre zero e um menor que o número total de filtros de evento retornados por GetNumberEventFilters (inclusive). Para obter mais informações sobre o índice dos filtros, consulte Código de índice e exceção.

[out, optional] Buffer

Recebe o comando de depurador que o mecanismo executará quando o evento ocorrer.

[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. 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

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

Requisitos

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h)

Confira também

GetExceptionFilterSecondCommand

Idebugcontrol

IDebugControl2

IDebugControl3

SetEventFilterCommand

sx, sxd, sxe, sxi, sxn (Definir exceções)