Compartir a través de

ICorDebug (Interfaz)

  • Artículo

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

Consulte también