Método IDebugAdvanced2::Request

Artículo
06/15/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

Solicitud [in]
Especifica qué operación se va a realizar. La solicitud puede ser uno de los valores de la tabla siguiente. Los detalles de cada operación se pueden encontrar siguiendo 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 del 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 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 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 datos tipados.

InBuffer [in, opcional]
Especifica la entrada a este método. El tipo y la interpretación de la entrada dependen del parámetro Request .

InBufferSize [in]
Especifica el tamaño del búfer de entrada InBuffer. Si la solicitud no requiere ninguna entrada, InBufferSize debe establecerse en cero.

OutBuffer [out, optional]
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 el resultado.

OutBufferSize [in]
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.

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

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 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.