Compartilhar via


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

Confira também