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
接收发生事件的进程的进程 ID。 如果此信息不可用,将改为返回DEBUG_ANY_ID。
[out] ThreadId
接收发生最后一个事件的线程的线程 ID。 如果此信息不可用,将改为返回DEBUG_ANY_ID。
[out, optional] ExtraInformation
接收有关事件的额外信息。 此额外信息的内容取决于返回 类型 参数指示的事件类型。 例如,如果 类型 为断点,ExtraInformation 包含 DEBUG_LAST_EVENT_INFO_BREAKPOINT;如果类型为异常,则 ExtraInformation 包含DEBUG_LAST_EVENT_INFO_EXCEPTION。 有关每个事件类型的结构定义的完整列表和 dbgeng.h 头文件,请参阅 DEBUG_EVENT_XXX。
如果 ExtraInformationNULL,则不会返回此信息。
[in] ExtraInformationSize
指定 ExtraInformation 指定的缓冲区的大小(以字节为单位)。
[out, optional] ExtraInformationUsed
接收额外信息的大小(以字节为单位)。 如果 ExtraInformationUsedNULL,则不会返回此信息。
[out, optional] Description
接收事件的说明。 如果 说明NULL,则不会返回此信息。
[in] DescriptionSize
指定 说明 指定的缓冲区的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。
[out, optional] DescriptionUsed
接收事件说明的大小(以字符为单位)。 此大小包括“\0”终止字符的空间。 如果 DescriptionUsed NULL,则不会返回此信息。
返回值
此方法也可能返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
|
该方法成功。 但是,ExtraInformationSize 或 DescriptionSize 小于相应数据或字符串的大小,并且数据或字符串被截断以适应缓冲区内。 |
言论
对于线程和进程创建事件,返回到 ThreadId 的线程 ID 和进程 ID,ProcessId 用于新创建的线程或进程。
有关最后一个事件的详细信息,请参阅主题 事件信息。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |