Метод IDebugAdvanced3::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	Верните контекст потока для хранимого события в файле мини-dump в режиме пользователя.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Возвращает идентификатор потока операционной системы для хранимого события в файле мини-dump в пользовательском режиме.
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	Чтение потока из целевого объекта мини-dump в пользовательском режиме.
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

Получает выходные данные из этого метода. Тип и интерпретация выходных данных зависит от параметра Request. Если OutBufferNULL, выходные данные не возвращаются.

[in] OutBufferSize

Задает размер выходного буфера OutBufferSize. Если тип выходных данных, возвращаемых в OutBuffer имеет известный размер, OutBufferSize обычно ожидается, что именно этот размер, даже если OutBuffer имеет значение NULL.

[out, optional] OutSize

Получает размер выходных данных, возвращаемых в выходном буфере OutBuffer. Если OutSizeNULL, эти сведения не возвращаются.

Возвращаемое значение

Интерпретация возвращаемого значения зависит от значения параметра запроса. Если иное не указано, могут быть возвращены следующие значения.

Возвращаемый код	Описание
S_OK	Метод был успешным.
S_FALSE	Метод был успешным. Однако выходные данные не будут помещаться в выходной буфер OutBuffer, поэтому усеченные выходные данные были возвращены.
E_INVALIDARG	Размер входного буфера InBufferSize или размер выходного буфера OutBufferSize не было ожидаемым значением.