Partilhar via


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

Ver também