IDebugAdvanced2：：Request 方法（dbgeng.h）

项目
02/06/2025

Request 方法执行各种不同的作。

语法

HRESULT Request(
  [in]            ULONG  Request,
  [in, optional]  PVOID  InBuffer,
  [in]            ULONG  InBufferSize,
  [out, optional] PVOID  OutBuffer,
  [in]            ULONG  OutBufferSize,
  [out, optional] PULONG OutSize
);

参数

[in] Request

指定要执行的作。请求可以是下表中的值之一。可以通过遵循“请求”列中的链接找到每个作的详细信息。

请求	行动
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	检查源服务器的源路径。
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	返回用户模式小型转储文件中存储事件的线程上下文。
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	返回用户模式小型转储文件中存储事件的作系统线程 ID。
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	返回用户模式小型转储文件中存储事件的异常记录。
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	返回默认进程创建选项。
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	设置默认进程创建选项。
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	返回当前在目标上运行的 Windows 版本。
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	从用户模式小型转储目标读取流。
DEBUG_REQUEST_TARGET_CAN_DETACH	检查调试器引擎是否可能从当前进程分离（使进程保持运行状态，但不再被调试）。
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	设置调试器引擎的隐式命令行。
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	返回当前事件的指令指针。
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	在当前事件的指令指针处返回最多 64 字节的内存。
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	执行各种不同的作，以帮助解释类型化数据。

[in, optional] InBuffer

指定此方法的输入。输入的类型和解释取决于请求参数。

[in] InBufferSize

指定 InBuffer 输入缓冲区的大小。如果请求不需要输入，InBufferSize 应设置为零。

[out, optional] OutBuffer

接收此方法的输出。输出的类型和解释取决于请求参数。如果 OutBufferNULL，则不返回输出。

[in] OutBufferSize

指定输出缓冲区的大小，OutBufferSize。如果返回给 OutBuffer 的输出类型具有已知大小，则通常应 OutBufferSize 的大小，即使 OutBuffer 设置为 NULL也是如此。

[out, optional] OutSize

接收输出缓冲区中返回的输出的大小，OutBuffer。如果 OutSizeNULL，则不会返回此信息。

返回值

返回值的解释取决于 Request 参数的值。除非另有说明，否则可能会返回以下值。

返回代码	描述
S_OK	该方法成功。
S_FALSE	该方法成功。但是，输出不适用于输出缓冲区 OutBuffer，因此返回截断的输出。
E_INVALIDARG	输入缓冲区的大小 InBufferSize 或输出缓冲区的大小 OutBufferSize 不是预期值。