ICorDebug (Interfaz)
Proporciona métodos que permiten a los desarrolladores depurar las aplicaciones en el entorno de Common Language Runtime (CLR).
Nota
No se admite la depuración en modo mixto (código administrado y nativo) en plataformas que no sean x86 (como IA-64 y IA64).
Métodos
Método | Descripción |
---|---|
Método CanLaunchOrAttach | Determina si es posible iniciar un nuevo proceso o asociarlo al proceso determinado en el contexto de la configuración actual del equipo y del entorno de ejecución. |
Método CreateProcess | Inicia un proceso y su subproceso principal bajo el control del depurador. |
Método DebugActiveProcess | Adjunta el depurador a un proceso existente. |
Método EnumerateProcesses | Obtiene un enumerador para los procesos que se están depurando. |
Método GetProcess | Devuelve el objeto "ICorDebugProcess" con el identificador de proceso especificado. |
Initialize (Método) | Inicializa el objeto ICorDebug . |
Método SetManagedHandler | Especifica el objeto de controlador de eventos para eventos administrados. |
Método SetUnmanagedHandler | Especifica el objeto de controlador de eventos para eventos no administrados. |
Terminate (Método) | Finaliza el objeto ICorDebug . |
Comentarios
ICorDebug
representa un bucle de procesamiento de eventos para un proceso del depurador. El depurador debe esperar a la devolución de llamada ICorDebugManagedCallback::ExitProcess de todos los procesos que se depuran antes de liberar esta interfaz.
El objeto ICorDebug
es el objeto inicial para controlar toda la depuración administrada posterior. En las versiones 1.0 y 1.1 de .NET Framework, este objeto era un objeto CoClass
creado a partir de COM. En .NET Framework, versión 2.0, este objeto ya no es un objeto CoClass
. Debe crearse mediante la función CreateDebuggingInterfaceFromVersion, que es más compatible con la versión. Esta nueva función de creación permite a los clientes obtener una implementación específica de ICorDebug
, que también emula una versión específica de la API de depuración.
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