Partilhar via


Método IDebugControl2::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. índice pode levar qualquer valor entre zero e um a menos do que o número total de filtros de evento retornados por GetNumberEventFilters (inclusive). Para obter mais informações sobre o índice dos filtros, consulte Índice e Código de 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 que o Buffer especifica. 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.

Valor de retorno

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

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Observações

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

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

GetExceptionFilterSecondCommand

IDebugControl

IDebugControl2

IDebugControl3

SetEventFilterCommand

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