Поделиться через


Метод IDebugControl2::GetEventFilterText (dbgeng.h)

Метод GetEventFilterText возвращает краткое описание события для определенного фильтра.

Синтаксис

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

Параметры

[in] Index

Указывает индекс фильтра событий, описание которого будет возвращено. Только к конкретным фильтрам прилагается описание; Индекс должен ссылаться на определенный фильтр.

[out, optional] Buffer

Получает описание конкретного фильтра.

[in] BufferSize

Задает размер буфера в символах, указанного в буфере . Этот размер включает пробел для символа завершения "\0".

[out, optional] TextSize

Получает размер описания события. Этот размер включает пробел для символа завершения "\0". Если TextSize имеет значение NULL, эти сведения не возвращаются.

Возвращаемое значение

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата Описание
S_OK
Метод выполнен успешно.
E_NOINTERFACE
Индекс не ссылается на определенный фильтр. Это может произойти, если Индекс ссылается на произвольный фильтр исключений.

Комментарии

Дополнительные сведения о фильтрах событий см. в разделе Фильтры событий.

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

GetSpecificFilterParameters

IDebugControl

IDebugControl2

IDebugControl3

sx, sxd, sxe, sxi, sxn (установка исключений)