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

Artigo
02/23/2024

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; O í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 especificado pelo Buffer . 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.

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.
E_NOINTERFACE	O índice não se refere a um filtro específico. Isso poderá ocorrer se Index se referir a um filtro de exceção arbitrário.