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

Artículo
02/23/2024

El método GetEventFilterText devuelve una breve descripción de un evento para un filtro específico.

Sintaxis

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

Parámetros

[in] Index

Especifica el índice del filtro de eventos cuya descripción se devolverá. Solo los filtros específicos tienen una descripción adjunta a ellos; El índice debe hacer referencia a un filtro específico.

[out, optional] Buffer

Recibe la descripción del filtro específico.

[in] BufferSize

Especifica el tamaño, en caracteres, del búfer que especifica buffer . Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] TextSize

Recibe el tamaño de la descripción del evento. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si TextSize es NULL, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_NOINTERFACE	El índice no hizo referencia a un filtro específico. Esto puede ocurrir si Index hace referencia a un filtro de excepción arbitrario.