Interface ICorDebugICorDebug Interface

Fornece métodos que permitem aos desenvolvedores depurar aplicativos no ambiente Common Language Runtime (CLR).Provides methods that allow developers to debug applications in the common language runtime (CLR) environment.

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).Mixed-mode (managed and native code) debugging is not supported on non-x86 platforms (such as IA64 and AMD64).

MétodosMethods

MétodoMethod DescriçãoDescription
Método CanLaunchOrAttachCanLaunchOrAttach Method Determina se é possível iniciar um novo processo ou anexá-lo ao processo fornecido no contexto da máquina atual e da configuração de tempo de execução.Determines whether launching a new process or attaching to the given process is possible within the context of the current machine and runtime configuration.
Método CreateProcessCreateProcess Method Inicia um processo e seu thread principal sob o controle do depurador.Launches a process and its primary thread under the control of the debugger.
Método DebugActiveProcessDebugActiveProcess Method Anexa o depurador a um processo existente.Attaches the debugger to an existing process.
Método EnumerateProcessesEnumerateProcesses Method Obtém um enumerador para os processos que estão sendo depurados.Gets an enumerator for the processes that are being debugged.
Método GetProcessGetProcess Method Retorna o objeto "ICorDebugProcess" com a ID de processo fornecida.Returns the "ICorDebugProcess" object with the given process ID.
Método InitializeInitialize Method Inicializa o objeto ICorDebug.Initializes the ICorDebug object.
Método SetManagedHandlerSetManagedHandler Method Especifica o objeto manipulador de eventos para eventos gerenciados.Specifies the event handler object for managed events.
Método SetUnmanagedHandlerSetUnmanagedHandler Method Especifica o objeto do manipulador de eventos para eventos não gerenciados.Specifies the event handler object for unmanaged events.
Método TerminateTerminate Method Encerra o ICorDebug objeto.Terminates the ICorDebug object.

ComentáriosRemarks

ICorDebug representa um loop de processamento de eventos para um processo do depurador.ICorDebug represents an event processing loop for a debugger process. O depurador deve aguardar o retorno de chamada ICorDebugManagedCallback:: ExitProcess de todos os processos que estão sendo depurados antes de liberar essa interface.The debugger must wait for the ICorDebugManagedCallback::ExitProcess callback from all processes being debugged before releasing this interface.

O ICorDebug objeto é o objeto inicial para controlar toda a depuração gerenciada adicional.The ICorDebug object is the initial object to control all further managed debugging. No .NET Framework versões 1,0 e 1,1, esse objeto era um CoClass objeto criado a partir de com.In the .NET Framework versions 1.0 and 1.1, this object was a CoClass object created from COM. No .NET Framework versão 2,0, esse objeto não é mais um CoClass objeto.In the .NET Framework version 2.0, this object is no longer a CoClass object. Ele deve ser criado pela função CreateDebuggingInterfaceFromVersion , que tem mais reconhecimento de versão.It must be created by the CreateDebuggingInterfaceFromVersion function, which is more version-aware. Essa 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.This new creation function enables clients to get a specific implementation of ICorDebug, which also emulates a specific version of the debugging API.

Observação

Esta interface não dá suporte para chamada remota, seja entre computadores ou processos cruzados.This interface does not support being called remotely, either cross-machine or cross-process.

RequisitosRequirements

Plataformas: confira Requisitos do sistema.Platforms: See System Requirements.

Cabeçalho: CorDebug.idl, CorDebug.hHeader: CorDebug.idl, CorDebug.h

Biblioteca: CorGuids.libLibrary: CorGuids.lib

.NET Framework versões:Disponível desde o 1.0Available since 1.0.NET Framework Versions: Disponível desde o 1.0Available since 1.0

Confira tambémSee also