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

Метод 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 . For example, if Type is breakpoint, ExtraInformation contains a DEBUG_LAST_EVENT_INFO_BREAKPOINT; if Type is Exception, ExtraInformation contains a DEBUG_LAST_EVENT_INFO_EXCEPTION. Полный список типов событий и файл заголовка dbgeng.h см. в DEBUG_EVENT_XXX для определений структуры для каждого типа события.

Если extraInformation имеет значение NULL, эти сведения не возвращаются.

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

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

[out, optional] Description

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

[in] DescriptionSize

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

[out, optional] DescriptionUsed

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

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

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

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

Комментарии

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

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

Требования

   
Целевая платформа Рабочий стол
Заголовок dbgeng.h (include Dbgeng.h)

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

GetStoredEventInformation

IDebugControl4