Método IDebugAdvanced2::Request (dbgeng.h)

Artículo
02/06/2025

El método Request realiza una variedad de operaciones diferentes.

Sintaxis

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

Parámetros

[in] Request

Especifica la operación que se va a realizar. solicitud puede ser uno de los valores de la tabla siguiente. Puede encontrar detalles de cada operación siguiendo el vínculo de la columna "Solicitud".

Pedir	Acción
DEBUG_REQUEST_SOURCE_PATH_HAS_SOURCE_SERVER	Compruebe la ruta de acceso de origen de un servidor de origen.
DEBUG_REQUEST_TARGET_EXCEPTION_CONTEXT	Devuelve el de contexto de subproceso de para el evento almacenado en un archivo minivolcado en modo de usuario.
DEBUG_REQUEST_TARGET_EXCEPTION_THREAD	Devuelve el identificador de subproceso del sistema operativo para el evento almacenado en un archivo minidump en modo de usuario.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Devuelve el registro de excepción para el evento almacenado en un archivo minidump en modo de usuario.
DEBUG_REQUEST_GET_ADDITIONAL_CREATE_OPTIONS	Devuelve las opciones de creación de procesos predeterminadas.
DEBUG_REQUEST_SET_ADDITIONAL_CREATE_OPTIONS	Establezca las opciones de creación de procesos predeterminadas.
DEBUG_REQUEST_GET_WIN32_MAJOR_MINOR_VERSIONS	Devuelve la versión de Windows que se está ejecutando actualmente en el destino.
DEBUG_REQUEST_READ_USER_MINIDUMP_STREAM	Lee una secuencia de un destino de minivolcado en modo de usuario.
DEBUG_REQUEST_TARGET_CAN_DETACH	Compruebe si es posible que el motor del depurador se desasocie del proceso actual (dejando el proceso en ejecución, pero ya no se depura).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Establezca el motor del depurador de línea de comandos implícita.
DEBUG_REQUEST_GET_CAPTURED_EVENT_CODE_OFFSET	Devuelve el puntero de instrucción del evento actual.
DEBUG_REQUEST_READ_CAPTURED_EVENT_CODE_STREAM	Devuelve hasta 64 bytes de memoria en el puntero de instrucción del evento actual.
DEBUG_REQUEST_EXT_TYPED_DATA_ANSI	Realice una variedad de operaciones diferentes que ayuden a interpretar los datos tipados.

[in, optional] InBuffer

Especifica la entrada para este método. El tipo y la interpretación de la entrada dependen del parámetro Request.

[in] InBufferSize

Especifica el tamaño del búfer de entrada inBuffer. Si la solicitud no requiere ninguna entrada, inBufferSize debe establecerse en cero.

[out, optional] OutBuffer

Recibe la salida de este método. El tipo y la interpretación de la salida dependen del parámetro Request. Si OutBuffer es null, no se devuelve la salida.

[in] OutBufferSize

Especifica el tamaño del búfer de salida OutBufferSize. Si el tipo de la salida devuelta a OutBuffer tiene un tamaño conocido, OutBufferSize normalmente se espera que sea exactamente ese tamaño, aunque OutBuffer esté establecido en NULL.

[out, optional] OutSize

Recibe el tamaño de la salida devuelta en el búfer de salida OutBuffer. Si OutSize es NULL, esta información no se devuelve.

Valor devuelto

La interpretación del valor devuelto depende del valor del parámetro Request. A menos que se indique lo contrario, se pueden devolver los valores siguientes.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
S_FALSE	El método se realizó correctamente. Sin embargo, la salida no cabería en el búfer de salida OutBuffer, por lo que se devolvió la salida truncada.
E_INVALIDARG	El tamaño del búfer de entrada inBufferSize o el tamaño del búfer de salida OutBufferSize no era el valor esperado.