IDebugControl3::GetLastEventInformation 方法 (dbgeng.h)

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

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

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

接收额外信息的大小(以字节为单位)。 如果 ExtraInformationUsedNULL,则不会返回此信息。

[out, optional] Description

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

[in] DescriptionSize

指定 说明 指定的缓冲区的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。

[out, optional] DescriptionUsed

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

返回值

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

返回代码 说明
S_OK
该方法成功。
S_FALSE
该方法成功。 但是, ExtraInformationSizeDescriptionSize 的大小较小,即相应的数据或字符串的大小,并且数据或字符串被截断以适应缓冲区中。

备注

对于线程和进程创建事件,返回到 ThreadIdProcessId 的线程索引和进程 ID 用于新创建的线程或进程。

有关最后一个事件的详细信息,请参阅主题 事件信息

要求

   
目标平台 桌面
Header dbgeng.h (包括 Dbgeng.h)

另请参阅

GetStoredEventInformation

IDebugControl

IDebugControl2

IDebugControl3