Partilhar via


Interface de ICorDebug

Fornece métodos que permitem aos desenvolvedores depurar aplicativos no ambiente de runtime (CLR) de idioma comum.

Observação

(Código gerenciado e nativo) de modo misto de depuração não é suportado no Windows 95, Windows 98 ou Windows ME ou plataformas de não - x86 (como, por exemplo, IA64 e AMD64).

Métodos

Método

Descrição

Método de ICorDebug::CanLaunchOrAttach

Determina se um novo processo de inicialização ou anexar a determinado processo é possível dentro do contexto de configuração de máquina e o tempo de execução atual.

Método de ICorDebug::CreateProcess

Inicia um processo e seu segmento principal sob o controle do depurador.

Método de ICorDebug::DebugActiveProcess

Anexa o depurador a um processo existente.

Método de ICorDebug::EnumerateProcesses

Obtém um enumerador para os processos que estão sendo depurados.

Método de ICorDebug::GetProcess

Retorna o ICorDebugProcess o objeto com a identificação de determinado processo.

Método de ICorDebug::Initialize

Inicializa o ICorDebug objeto.

Método de ICorDebug::SetManagedHandler

Especifica o objeto de manipulador de eventos para eventos gerenciados.

Método de ICorDebug::SetUnmanagedHandler

Especifica o objeto de manipulador de eventos para eventos de não gerenciados.

Método de ICorDebug::Terminate

Encerra o ICorDebug objeto.

Comentários

ICorDebugrepresenta um loop de processamento de evento para um processo do depurador. O depurador deve aguardar a ICorDebugManagedCallback::ExitProcess o retorno de chamada de todos os processos que está sendo depurado antes de liberar essa interface.

O ICorDebug é o objeto inicial para controlar a depuração gerenciada tudo ainda mais. 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, esse objeto não é mais um CoClass objeto. Ele deve ser criado pelo CreateDebuggingInterfaceFromVersion função, que é mais ciente de versão. Essa nova função de criação permite aos clientes obter uma implementação específica da ICorDebug, também, que emula uma versão específica da API de depuração.

Observação

Esta interface não dá suporte a que está sendo chamado remotamente, entre computadores ou entre processos.

Requisitos

Plataformas: Consulte Requisitos de sistema do .NET Framework.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

.NET Framework versões: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0, 1.1, 1.0

Consulte também

Outros recursos

Interfaces de depuração.