Interfaz ICorDebugStepper
Representa un paso en la ejecución del código realizado por un depurador, actúa como identificador entre la emisión y la finalización de un comando, y proporciona un modo de cancelar un paso.
Métodos
| método | Descripción |
|---|---|
| Método Deactivate | Hace que ICorDebugStepper cancele el último comando de paso que recibió. |
| IsActive (Método) | Obtiene un valor que indica si ICorDebugStepper está ejecutando actualmente un paso. |
| Método SetInterceptMask | Establece un valor CorDebugIntercept que especifica los tipos de código en los que se depuran paso a paso por instrucciones. |
| Método SetRangeIL | Establece un valor que indica si las llamadas a ICorDebugStepper::StepRange pasan valores de argumento con respecto al código nativo o al código de lenguaje intermedio común (CIL) del método que se está realizando paso a paso. |
| Método SetUnmappedStopMask | Establece un valor CorDebugUnmappedStop que especifica el tipo de código desasignado en el que se detendrá la ejecución. |
| Método Step | Hace que ICorDebugStepper siga un solo paso en el subproceso que lo contiene y, de forma opcional, continúe con un solo mediante las funciones que se llaman en el subproceso. |
| Método StepOut | Hace que ICorDebugStepper siga un solo paso en el subproceso que lo contiene y se complete cuando el marco actual devuelva el control al marco de llamada. |
| Método StepRange | Hace que ICorDebugStepper siga un solo paso en el subproceso que lo contiene y vuelva cuando alcance el código que está más allá del último de los rangos especificados. |
Comentarios
La interfaz ICorDebugStepper sirve para los siguientes objetivos:
Actúa como un identificador entre un comando de paso que se emite y la finalización de dicho comando.
Proporciona una interfaz central para encapsular toda la ejecución paso a paso que se puede realizar.
Proporciona una forma de cancelar antes de tiempo una operación de ejecución paso a paso.
Puede haber más de un paso por subproceso. Por ejemplo, se puede alcanzar un punto de interrupción mientras se pasa por una función y es posible que el usuario quiera iniciar una nueva operación de ejecución paso a paso dentro de esa función. El depurador debe determinar cómo se controla esta situación. Es posible que el depurador quiera cancelar la operación de ejecución paso a paso original o bien anidar las dos operaciones. La interfaz ICorDebugStepper admite ambas opciones.
Un paso a paso puede migrar entre subprocesos si Common Language Runtime (CLR) realiza una llamada serializada entre subprocesos.
Nota
Esta interfaz no admite que se la llame de forma remota, ya sea entre procesos o entre equipos.
Requisitos
Plataformas: Vea Requisitos de sistema.
Encabezado: CorDebug.idl, CorDebug.h
Biblioteca: CorGuids.lib
Versiones de .NET Framework: está disponible desde la versión 1.0
