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

Статья
02/26/2024

Метод 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

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

[out, optional] ExtraInformationUsed

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] DescriptionUsed

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

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

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

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

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

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