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

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

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