IDebugProgram2
Esta interfaz representa un programa que se ejecuta en un proceso.
Sintaxis
IDebugProgram2 : IUnknown
Notas para los implementadores
El motor de depuración (DE) y un proveedor de puertos personalizado implementan esta interfaz para representar un programa en un proceso. El administrador de depuración de sesión (SDM) también implementa esta interfaz para proporcionar información a Attach.
Notas para autores de la llamada
El evento IDebugProgramCreateEvent2 devuelve esta interfaz para un nuevo programa. Esta interfaz también se usa como parámetro para muchos métodos en varias interfaces.
Métodos en orden de Vtable
En la tabla siguiente se muestran los métodos de IDebugProgram2.
| Método | Descripción |
|---|---|
| EnumThreads | Enumera los subprocesos que se ejecutan en este programa. |
| GetName | Obtiene el nombre del programa. |
| GetProcess | Obtiene el proceso en el que se ejecuta este programa. |
| Terminate | Finaliza este programa. |
| Adjuntar | Adjunta a este programa. |
| CanDetach | Determina si un motor de depuración (DE) puede desasociar del programa. |
| Separar | Desasocia el depurador de este programa. |
| GetProgramId | Obtiene un identificador único global para este programa. |
| GetDebugProperty | Obtiene las propiedades del programa. |
| Ejecutar | Continúa ejecutando este programa desde un estado detenido. Se borra cualquier estado de ejecución anterior. |
| Continuar | Continúa ejecutando este programa desde un estado detenido. Se conserva cualquier estado de ejecución anterior. |
| Step | Realiza un paso. |
| CauseBreak | Solicita que este programa detenga la ejecución la próxima vez que uno de sus subprocesos ejecute código. |
| GetEngineInfo | Obtiene el nombre y el identificador del motor de depuración (DE) que ejecuta este programa. |
| EnumCodeContexts | Enumera los contextos de código de una posición determinada en un archivo de código fuente. |
| GetMemoryBytes | Obtiene los bytes de memoria de este programa. |
| GetDisassemblyStream | Obtiene la secuencia de desensamblaje de este programa o parte de este programa. |
| EnumModules | Enumera los módulos que este programa ha cargado y se está ejecutando. |
| GetENCUpdate | Obtiene la actualización Editar y continuar (ENC) de este programa. Un motor de depuración personalizado no implementa este método (siempre debe devolver E_NOTIMPL). |
| EnumCodePaths | Enumera las rutas de acceso de código de este programa. |
| WriteDump | Escribe un volcado de memoria en un archivo. |
Requisitos
Encabezado: msdbg.h
Espacio de nombres: Microsoft.VisualStudio.Debugger.Interop
Ensamblado: Microsoft.VisualStudio.Debugger.Interop.dll
Comentarios
Un programa es un contenedor de subprocesos que se ejecuta en una arquitectura en tiempo de ejecución determinado, mientras que un proceso se compone de uno o varios programas.