Interface ICorDebug

  • Artigo

Fornece métodos que permitem aos desenvolvedores depurar aplicativos no ambiente do 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).

Métodos

Método Descrição
Método CanLaunchOrAttach Determina se iniciar um novo processo ou anexar ao processo fornecido é possível dentro do 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 objeto ICorDebug.
Método SetManagedHandler Especifica o objeto manipulador de eventos para eventos gerenciados.
Método SetUnmanagedHandler Especifica o objeto manipulador de eventos para eventos não gerenciados.
Método Terminate Encerra o ICorDebug objeto.

Comentários

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 é o objeto inicial para controlar toda a depuração gerenciada adicional. No .NET Framework versões 1.0 e 1.1, esse objeto foi um objeto CoClass criado com base em COM. No .NET Framework versão 2.0, esse objeto não é mais um objeto CoClass. Ele deve ser criado pela função CreateDebuggingInterfaceFromVersion, que tem mais reconhecimento de versão. Essa nova função de criação permite que os clientes obtenham uma implementação específica de ICorDebug, que também emula uma versão específica da API de depuração.

Observação

Esta interface não pode ser chamada remotamente, seja entre computadores ou entre processos.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.lib

Versões do .NET Framework: Disponíveis desde a versão 1.0

Confira também