ICorDebug Interface

Fornece métodos que permitem aos desenvolvedores depurar aplicativos no ambiente CLR (Common Language Runtime).

Observação

Não há suporte para depuração de modo misto (código gerenciado e nativo) em plataformas não x86 (como IA64 e AMD64).

Methods

Método	Description
Método CanLaunchOrAttach	Determina se a inicialização de um novo processo ou a anexação ao processo determinado é possível no contexto da configuração atual do computador e do runtime.
Método CreateProcess	Inicia um processo e seu thread primário sob o controle do depurador.
Método DebugActiveProcess	Anexa o depurador a um processo existente.
Método EnumerateProcesses	Obtém um enumerador para os processos que estão sendo depurados.
Método GetProcess	Retorna o objeto "ICorDebugProcess" com a ID de processo fornecida.
Método Initialize	Inicializa o ICorDebug objeto.
Método SetManagedHandler	Especifica o objeto do manipulador de eventos para eventos gerenciados.
Método SetUnmanagedHandler	Especifica o objeto do manipulador de eventos para eventos não gerenciados.
Método Terminate	Encerra o ICorDebug objeto.

Observações

ICorDebug representa um loop de processamento de eventos para um processo de depurador. O depurador deve aguardar o retorno de chamada ICorDebugManagedCallback::ExitProcess de todos os processos que estão sendo depurados antes de liberar essa interface.

O ICorDebug objeto deve ser criado pela função CreateDebuggingInterfaceFromVersion , que permite que os clientes obtenham uma implementação específica que ICorDebug emula uma versão específica da API de depuração.

Observação

Essa interface não dá suporte a ser chamada remotamente, seja entre máquinas ou entre processos.

Requirements

Plataformas: Consulte sistemas operacionais com suporte do .NET.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET: Disponível desde o .NET Framework 1.0