IDebugProcess2
Essa interface representa um processo em execução em uma porta. Se a porta for a porta local, geralmente IDebugProcess2 representa um processo físico na máquina local.
Sintaxe
IDebugProcess2 : IUnknown
Notas para implementadores
Essa interface é implementada por um fornecedor de porta personalizado para gerenciar programas como um grupo. Essa interface deve ser implementada pelo fornecedor portuário.
Um mecanismo de depuração também implementa essa interface se oferecer suporte à inicialização de um programa por meio de LaunchSuspended.
Observações para chamadores
Essa interface é chamada principalmente pelo gerenciador de depuração de sessão (SDM) para interagir com um grupo de programas identificados nesse processo.
Chame GetProcess ou GetProcess para obter essa interface. Essa interface também é retornada chamando IDebugEngineLaunch2::LaunchSuspended.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugProcess2.
| Método | Descrição |
|---|---|
| GetInfo | Obtém uma descrição do processo. |
| EnumPrograms | Enumera os programas contidos nesse processo. |
| GetName | Obtém o título, nome amigável ou nome de arquivo do processo. |
| GetServer | Obtém a instância de um servidor de máquina em que esse processo está sendo executado. |
| Encerrar | Encerra o processo. |
| Attach | Anexa ao processo. |
| CanDetach | Determina se o SDM pode desanexar o processo. |
| Desanexar | Desanexa o depurador do processo. |
| GetPhysicalProcessId | Obtém o identificador do processo do sistema. |
| GetProcessId | Obtém um identificador global exclusivo para esse processo. |
| GetAttachedSessionName [PRETERIDO] |
Obtém o nome da sessão que está depurando o processo. [PRETERIDO. DEVE SEMPRE VOLTAR E_NOTIMPL.] |
| EnumThreads | Enumera os threads em execução no processo. |
| CauseBreak | Solicita que o próximo programa que executa código neste processo pare. |
| GetPort | Obtém a porta em que esse processo está sendo executado. |
Comentários
Um IDebugProcess2 contém uma ou mais interfaces IDebugProgram2 .
Requisitos
Cabeçalho: Msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll