Partilhar via


IDebugProgram2

Essa interface representa um programa que está sendo executado em um processo.

IDebugProgram2 : IUnknown

Observações para Implementadores

O mecanismo de depuração (DE) e um fornecedor de porta personalizada implementam essa interface para representar um programa em um processo. O Gerenciador de sessão de depuração (SDM) também implementa essa interface para fornecer informações para IDebugProgram2::Attach.

Observações para chamadores

O IDebugProgramCreateEvent2 evento retorna essa interface para um novo programa. Essa interface também é usada como um parâmetro para muitos métodos em várias interfaces.

Métodos na ordem de Vtable

A tabela a seguir mostra os métodos de IDebugProgram2.

Método

Descrição

IDebugProgram2::EnumThreads

Enumera os threads em execução neste programa.

IDebugProgram2::GetName

Obtém o nome do programa.

IDebugProgram2::GetProcess

Obtém o que este programa está sendo executado no processo.

IDebugProgram2::Terminate

Encerra este programa.

IDebugProgram2::Attach

Anexa a este programa.

IDebugProgram2::CanDetach

Determina se um mecanismo de depuração (DE) pode desconectar-se de que o programa.

IDebugProgram2::Detach

Desanexa o depurador a partir deste programa.

IDebugProgram2::GetProgramId

Obtém um identificador exclusivo para este programa.

IDebugProgram2::GetDebugProperty

Obtém propriedades de programa.

IDebugProgram2::Execute

Continua a executar este programa a partir de um estado de parado. Qualquer estado de execução anterior está desmarcado.

IDebugProgram2::Continue

Continua a executar este programa a partir de um estado de parado. Qualquer estado de execução anterior será preservado.

IDebugProgram2::Step

Realiza uma etapa.

IDebugProgram2::CauseBreak

Solicitações que este programa parar a execução na próxima vez um dos seu código de execução de threads.

IDebugProgram2::GetEngineInfo

Obtém o nome e o identificador do mecanismo de depuração (DE) executar este programa.

IDebugProgram2::EnumCodeContexts

Enumera os contextos de código para uma determinada posição em um arquivo de origem.

IDebugProgram2::GetMemoryBytes

Obtém os bytes de memória para este programa.

IDebugProgram2::GetDisassemblyStream

Obtém o fluxo de desmontagem para este programa ou uma parte desse programa.

IDebugProgram2::EnumModules

Enumera os módulos que este programa foi carregado e está em execução.

IDebugProgram2::GetENCUpdate

Obtém a atualização de editar e continuar (ENC) para este programa.

Um mecanismo personalizado de depuração não implementa esse método (ele deve retornar sempre E_NOTIMPL).

IDebugProgram2::EnumCodePaths

Enumera os caminhos de código deste programa.

IDebugProgram2::WriteDump

Grava um despejo em um arquivo.

Requisitos

Cabeçalho: msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Comentários

Um programa é um recipiente de thread em execução em uma arquitetura de tempo de execução específica, enquanto um processo é composto de um ou mais programas.

Consulte também

Referência

IDebugThread2::GetProgram

IEnumDebugPrograms2::Next

IDebugPortEvents2::Event

IDebugEngine2::Attach

IDebugEngine2::DestroyProgram

IDebugEventCallback2::Event

IDebugProgramNode2::Attach_V7

Conceitos

Interfaces principais