通过

IDebugControl4：：GetStoredEventInformation 方法 （dbgeng.h）

  • 项目

GetStoredEventInformation 方法检索有关当前目标中可用的事件的信息。

语法

HRESULT GetStoredEventInformation(
  [out]           PULONG Type,
  [out]           PULONG ProcessId,
  [out]           PULONG ThreadId,
  [out, optional] PVOID  Context,
  [in]            ULONG  ContextSize,
  [out, optional] PULONG ContextUsed,
  [out, optional] PVOID  ExtraInformation,
  [in]            ULONG  ExtraInformationSize,
  [out, optional] PULONG ExtraInformationUsed
);

参数

[out] Type

接收存储事件的类型。 有关可能类型的列表，请参阅 DEBUG_EVENT_XXX。

[out] ProcessId

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

[out] ThreadId

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

[out, optional] Context

接收存储事件的 线程上下文。 线程上下文的类型是事件发生时目标有效处理器的 CONTEXT 结构。 上下文 缓冲区必须足够大才能保存此结构。 如果 上下文NULL，则不会返回此信息。

[in] ContextSize

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

[out, optional] ContextUsed

接收上下文的大小（以字节为单位）。 如果 ContextUsedNULL，则不会返回此信息。

[out, optional] ExtraInformation

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

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

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

返回值

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

返回代码 描述
S_OK
 该方法成功。

言论

许多目标没有兴趣事件。

如果目标是用户模式小型转储文件，转储文件生成器可能会存储其他事件。 通常，这是引发生成器保存转储文件的事件。

有关详细信息，请参阅主题 事件信息。

要求

要求 价值
目标平台 桌面
标头 dbgeng.h （包括 Dbgeng.h、Ntddk.h）

另请参阅

GetLastEventInformation

IDebugControl4