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 结构。 上下文缓冲区必须足够大才能容纳此结构。 如果 Context 为 NULL，则不会返回此信息。

[in] ContextSize

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

[out, optional] ContextUsed

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

[out, optional] ExtraInformation

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

[in] ExtraInformationSize

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

[out, optional] ExtraInformationUsed

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

返回值

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

返回代码 说明
S_OK
 方法成功。

注解

许多目标没有感兴趣的事件。

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

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

要求

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

另请参阅

GetLastEventInformation

IDebugControl4