Метод IDebugControl4::GetLastEventInformationWide (dbgeng.h)

Статья
08/07/2023

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

Синтаксис

HRESULT GetLastEventInformationWide(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed,
  [out, optional] PWSTR  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

Получает дополнительные сведения о событии. Содержимое этих дополнительных сведений зависит от типа события, указанного возвращаемым параметром Type . Например, если type — точка останова, ExtraInformation содержит DEBUG_LAST_EVENT_INFO_BREAKPOINT; Если type имеет значение Exception, ExtraInformation содержит DEBUG_LAST_EVENT_INFO_EXCEPTION. Полный список типов событий и файл заголовка dbgeng.h для определений структуры для каждого типа событий см. в DEBUG_EVENT_XXX .

Если параметр 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 , предназначены для только что созданного потока или процесса.

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

Требования

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

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

GetStoredEventInformation

IDebugControl4