ICorDebug Interface
Fornece métodos que permitem aos programadores depurar aplicações no ambiente de runtime de linguagem comum (CLR).
Nota
A depuração do modo misto (código gerido e nativo) não é suportada em plataformas não x86 (como IA64 e AMD64).
Métodos
Método | Descrição |
---|---|
Método CanLaunchOrAttach | Determina se é possível iniciar um novo processo ou anexar ao processo especificado no contexto da configuração atual do computador e do runtime. |
Método CreateProcess | Inicia um processo e o respetivo thread principal sob o controlo 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 a ser depurados. |
Método GetProcess | Devolve o objeto "ICorDebugProcess" com o ID do processo especificado. |
Método Initialize | Inicializa o ICorDebug objeto. |
Método SetManagedHandler | Especifica o objeto do processador de eventos para eventos geridos. |
Método SetUnmanagedHandler | Especifica o objeto do processador de eventos para eventos não geridos. |
Método De Terminação | Termina o ICorDebug objeto. |
Observações
ICorDebug
representa um ciclo de processamento de eventos para um processo de depurador. O depurador tem de aguardar pela chamada de retorno ICorDebugManagedCallback::ExitProcess de todos os processos que estão a ser depurados antes de lançar esta interface.
O ICorDebug
objeto é o objeto inicial para controlar toda a depuração gerida adicional. No .NET Framework versões 1.0 e 1.1, este objeto foi um CoClass
objeto criado a partir de COM. No .NET Framework versão 2.0, este objeto já não é um CoClass
objeto. Tem de ser criada pela função CreateDebuggingInterfaceFromVersion , que tem mais suporte para versões. Esta nova função de criação permite que os clientes obtenham uma implementação específica do ICorDebug
, que também emula uma versão específica da API de depuração.
Nota
Esta interface não suporta ser chamada remotamente, nem entre máquinas nem em processos cruzados.
Requisitos
Plataformas: Veja Requisitos do Sistema.
Cabeçalho: CorDebug.idl, CorDebug.h
Biblioteca: CorGuids.lib
.NET Framework Versões: Disponível desde 1.0