Метод IDebugAdvanced3::Request (dbgeng.h)

Статья
02/23/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	Возвращает идентификатор потока операционной системы для сохраненного события в файле минидампа пользовательского режима.
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 не является ожидаемым значением.