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
Замечания
Программа — это контейнер потоков, работающий в определенной архитектуре времени выполнения, а процесс состоит из одной или нескольких программ.