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
接收有关事件的额外信息。 此额外信息的内容取决于返回的 Type 参数指示的事件类型。 例如,如果 Type 为断点, 则 ExtraInformation 包含DEBUG_LAST_EVENT_INFO_BREAKPOINT;如果 Type 为 Exception,则 ExtraInformation 包含DEBUG_LAST_EVENT_INFO_EXCEPTION。 有关事件类型的完整列表和 dbgeng.h 头文件,请参阅 DEBUG_EVENT_XXX ,了解每种事件类型的结构定义。
如果 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,则不返回此信息。
返回值
此方法也可能返回错误值。 有关更多详细信息 ,请参阅返回值 。
返回代码 | 说明 |
---|---|
|
方法成功。 |
|
方法成功。 但是, ExtraInformationSize 或 DescriptionSize 小于相应数据或字符串的大小,并且数据或字符串被截断以适合缓冲区内。 |
注解
对于线程和进程创建事件,返回到 ThreadId 和 ProcessId 的线程 ID 和 进程 ID 用于新创建的线程或进程。
有关上一个事件的详细信息,请参阅主题 事件信息。
要求
要求 | 值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |