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

Artículo
03/08/2023

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. La solicitud puede ser uno de los valores de la tabla siguiente. Para encontrar detalles de cada operación, siga el vínculo de la columna "Solicitud".

Solicitud	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 contexto del subproceso 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 minivolcado en modo de usuario.
DEBUG_REQUEST_TARGET_EXCEPTION_RECORD	Devuelve el registro de excepción para el evento almacenado en un archivo minivolcado 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 desde 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 está depurando).
DEBUG_REQUEST_SET_LOCAL_IMPLICIT_COMMAND_LINE	Establezca la línea de comandos implícita del motor del depurador.
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 en la interpretación de los datos tipados.

[in, optional] InBuffer

Especifica la entrada a 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, se espera que OutBufferSize sea exactamente ese tamaño, incluso si 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	Método realizado correctamente.
S_FALSE	Método realizado correctamente. Sin embargo, la salida no cabrí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.