Interface ICorDebug
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
