IDebugProgram2
Essa interface representa um programa que está sendo executado em um processo.
Sintaxe
IDebugProgram2 : IUnknown
Notas para implementadores
O mecanismo de depuração (DE) e um fornecedor de porta personalizado implementam essa interface para representar um programa em um processo. O gerenciador de depuração de sessão (SDM) também implementa essa interface para fornecer informações ao Attach.
Observações para chamadores
O evento IDebugProgramCreateEvent2 retorna essa interface para um novo programa. Essa interface também é usada como parâmetro para muitos métodos em várias interfaces.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugProgram2.
| Método | Descrição |
|---|---|
| EnumThreads | Enumera os threads que estão sendo executados neste programa. |
| GetName | Obtém o nome do programa. |
| GetProcess | Obtém o processo em que este programa está sendo executado. |
| Encerrar | Encerra este programa. |
| Attach | Anexa a este programa. |
| CanDetach | Determina se um mecanismo de depuração (DE) pode se desanexar do programa. |
| Desanexar | Desanexa o depurador deste programa. |
| GetProgramId | Obtém um identificador global exclusivo para este programa. |
| GetDebugProperty | Obtém propriedades do programa. |
| Executar | Continua executando este programa a partir de um estado parado. Qualquer estado de execução anterior é limpo. |
| Continuar | Continua executando este programa a partir de um estado parado. Qualquer estado de execução anterior é preservado. |
| Step | Executa uma etapa. |
| CauseBreak | Solicita que este programa pare a execução na próxima vez que um de seus threads executar código. |
| GetEngineInfo | Obtém o nome e o identificador do mecanismo de depuração (DE) que executa este programa. |
| EnumCodeContexts | Enumera os contextos de código para uma determinada posição em um arquivo de origem. |
| GetMemoryBytes | Obtém os bytes de memória para este programa. |
| GetDisassemblyStream | Obtém o fluxo de desmontagem para este programa ou parte deste programa. |
| EnumModules | Enumera os módulos que este programa carregou e está executando. |
| GetENCUpdate | Obtém a atualização Editar e Continuar (ENC) para este programa. Um mecanismo de depuração personalizado não implementa esse método (ele sempre deve retornar E_NOTIMPL). |
| EnumCodePaths | Enumera os caminhos de código deste programa. |
| WriteDump | Grava um despejo em um arquivo. |
Requisitos
Cabeçalho: msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll
Comentários
Um programa é um contêiner de thread em execução em uma arquitetura de tempo de execução específica, enquanto um processo é composto de um ou mais programas.