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

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

[in] DescriptionSize

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

[out, optional] DescriptionUsed

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

返回值

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

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

注解

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

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

要求

要求
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

GetStoredEventInformation

IDebugControl

IDebugControl2

IDebugControl3