IDebugAdvanced3：：Request 方法 (dbgeng.h)

项目
02/26/2024

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

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

[in] InBufferSize

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

[out, optional] OutBuffer

从此方法接收输出。输出的类型和解释取决于 Request 参数。如果 OutBuffer 为 NULL，则不返回输出。

[in] OutBufferSize

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

[out, optional] OutSize

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

返回值

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

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