IDebugProgram2
Этот интерфейс представляет программу, которая выполняется в процессе.
Синтаксис
IDebugProgram2 : IUnknown
Примечания для разработчиков
Обработчик отладки (DE) и настраиваемый поставщик портов реализуют этот интерфейс для представления программы в процессе. Диспетчер отладки сеансов (SDM) также реализует этот интерфейс для предоставления сведений для присоединения.
Заметки для вызывающих абонентов
Событие IDebugProgramCreateEvent2 возвращает этот интерфейс для новой программы. Этот интерфейс также используется в качестве параметра для многих методов в нескольких интерфейсах.
Методы в порядке таблицы Vtable
В следующей таблице показаны методы IDebugProgram2.
| Метод | Description |
|---|---|
| EnumThreads | Перечисляет потоки, выполняемые в этой программе. |
| GetName | Возвращает имя программы. |
| GetProcess | Возвращает процесс, в котором выполняется эта программа. |
| Завершение | Завершает эту программу. |
| Присоединить | Присоединяется к этой программе. |
| CanDetach | Определяет, может ли подсистема отладки (DE) отсоединяться от программы. |
| Отсоединить | Отключает отладчик от этой программы. |
| GetProgramId | Получает глобальный уникальный идентификатор для этой программы. |
| GetDebugProperty | Возвращает свойства программы. |
| Execute | Продолжает выполнять эту программу из остановленного состояния. Любое предыдущее состояние выполнения очищается. |
| Продолжить | Продолжает выполнять эту программу из остановленного состояния. Сохраняется любое предыдущее состояние выполнения. |
| Step | Выполняет шаг. |
| CauseBreak | Запрашивает, что эта программа остановит выполнение в следующий раз, когда один из его потоков запускает код. |
| GetEngineInfo | Возвращает имя и идентификатор обработчика отладки (DE), выполняющего эту программу. |
| EnumCodeContexts | Перечисляет контексты кода для заданной позиции в исходном файле. |
| GetMemoryBytes | Возвращает байты памяти для этой программы. |
| GetDisassemblyStream | Возвращает поток дизассембли для этой программы или части этой программы. |
| EnumModules | Перечисляет модули, загруженные этой программой, и выполняется. |
| GetENCUpdate | Возвращает обновление для этой программы "Изменить и продолжить" (ENC). Пользовательская подсистема отладки не реализует этот метод (он всегда должен возвращать E_NOTIMPL). |
| EnumCodePaths | Перечисляет пути кода этой программы. |
| WriteDump | Записывает дамп в файл. |
Requirements
Заголовок: msdbg.h
Пространство имен: Microsoft.VisualStudio.Debugger.Interop
Сборка: Microsoft.VisualStudio.Debugger.Interop.dll
Замечания
Программа — это контейнер потоков, работающий в определенной архитектуре времени выполнения, а процесс состоит из одной или нескольких программ.