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

Статья
02/06/2025

Метод getLastEventInformation возвращает сведения о последнем событии, которое произошло в целевом объекте.

Синтаксис

HRESULT GetLastEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PSTR   Description,
  [in]            ULONG  DescriptionSize,
  [out, optional] PULONG DescriptionUsed
);

Параметры

[out] Type

Получает тип последнего события, созданного целевым объектом. Список возможных типов см. в DEBUG_EVENT_XXX.

[out] ProcessId

Получает идентификатор процесса процесса, в котором произошло событие. Если эта информация недоступна, DEBUG_ANY_ID будет возвращена вместо этого.

[out] ThreadId

Получает индекс потока (а не идентификатор потока), в котором произошло последнее событие. Если эта информация недоступна, DEBUG_ANY_ID будет возвращена вместо этого.

[out, optional] ExtraInformation

Получает дополнительные сведения о событии. Содержимое этой дополнительной информации зависит от типа события. Если ExtraInformation значение NULL, эти сведения не возвращаются.

[in] ExtraInformationSize

Задает размер в байтах буфера, который ЭкстраInformation.

[out, optional] ExtraInformationUsed

Получает размер в байтах дополнительных сведений. Если ExtraInformationUsedNULL, эти сведения не возвращаются.

[out, optional] Description

Получает описание события. Если описанияNULL, эти сведения не возвращаются.

[in] DescriptionSize

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

[out, optional] DescriptionUsed

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

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

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

Возвращаемый код	Описание
S_OK	Метод был успешным.
S_FALSE	Метод был успешным. Однако ExtraInformationSize или DescriptionSize были меньше, чем размер соответствующих данных или строк, а данные или строка были усечены для размещения внутри буфера.

Замечания

Для событий создания потоков и процессов индекс и идентификатор процесса, возвращенные в ThreadId и ProcessId, предназначены для только что созданного потока или процесса.

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