IDebugAdvanced3::Request 方法 (dbgeng.h)

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 参数。 如果 OutBufferNULL,则不返回输出。

[in] OutBufferSize

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

[out, optional] OutSize

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

返回值

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

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

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

要求

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

另请参阅

DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET

DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS

DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM

DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM

DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS

DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE

DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER

DEBUG_REQUEST_TARGET_CAN_DETACH

DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT

DEBUG_REQUEST_TARGET_EXCEPTION_RECORD

DEBUG_REQUEST_TARGET_EXCEPTION_THREAD

IDebugAdvanced2

IDebugAdvanced3