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

接收发生事件的进程的进程 ID。如果此信息不可用，将改为返回DEBUG_ANY_ID。

[out] ThreadId

接收线程索引 (而不是发生最后一个事件的线程的线程 ID) 。如果此信息不可用，将改为返回DEBUG_ANY_ID。

[out, optional] ExtraInformation

接收有关事件的额外信息。此额外信息的内容取决于事件的类型。如果 ExtraInformation 为 NULL，则不会返回此信息。

[in] ExtraInformationSize

指定 ExtraInformation 指定的缓冲区的大小（以字节为单位）。

[out, optional] ExtraInformationUsed

接收额外信息的大小（以字节为单位）。如果 ExtraInformationUsed 为 NULL，则不会返回此信息。

[out, optional] Description

接收事件的说明。如果 Description 为 NULL，则不会返回此信息。

[in] DescriptionSize

指定 Description 指定的缓冲区的大小（以字符为单位）。此大小包括“\0”终止字符的空间。

[out, optional] DescriptionUsed

接收事件说明的大小（以字符为单位）。此大小包括“\0”终止字符的空间。如果 DescriptionUsed 为 NULL，则不会返回此信息。

返回值

此方法也可能返回错误值。有关更多详细信息，请参阅返回值。

返回代码	说明
S_OK	方法成功。
S_FALSE	方法成功。但是， ExtraInformationSize 或 DescriptionSize 都小于相应数据或字符串的大小，并且数据或字符串被截断以适合缓冲区内。