Compartilhar via


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

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)