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

Artigo
02/06/2025

O método GetEventFilterText retorna uma breve descrição de um evento para um filtro específico.

Sintaxe

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

Parâmetros

[in] Index

Especifica o índice do filtro de evento cuja descrição será retornada. Somente os filtros específicos têm uma descrição anexada a eles; índice deve se referir a um filtro específico.

[out, optional] Buffer

Recebe a descrição do filtro específico.

[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] TextSize

Recebe o tamanho da descrição do evento. Esse tamanho inclui o espaço para o caractere de terminação '\0'. Se TextSize 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.
E_NOINTERFACE	índice não se referiu a um filtro específico. Isso pode ocorrer se Index se referir a um filtro de exceção arbitrário.

Observações

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

Requisitos

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

Consulte também

GetSpecificFilterParameters

IDebugControl

IDebugControl2

IDebugControl3

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

Compartilhar via