Interface ICorDebug

Artigo
08/25/2010

Fornece métodos que permitem aos desenvolvedores depurar aplicativos no Common linguagem tempo de execução ambiente (CLR).

Observação:
Misto- não é tem suporte a depuração de modo (código gerenciado e nativo) no Windows 95, Windows 98 ou Windows ME ou plataformas não-x86 (por exemplo, IA64 ou AMD64).

interface ICorDebug : IUnknown {
        
    HRESULT CanLaunchOrAttach (
        [in] DWORD                         dwProcessId,
        [in] BOOL                          win32DebuggingEnabled
    );
        
    HRESULT CreateProcess (
        [in] LPCWSTR                       lpApplicationName,
        [in] LPWSTR                        lpCommandLine,
        [in] LPSECURITY_ATTRIBUTES         lpProcessAttributes,
        [in] LPSECURITY_ATTRIBUTES         lpThreadAttributes,
        [in] BOOL                          bInheritHandles,
        [in] DWORD                         dwCreationFlags,
        [in] PVOID                         lpEnvironment,
        [in] LPCWSTR                       lpCurrentDirectory,
        [in] LPSTARTUPINFOW                lpStartupInfo,
        [in] LPPROCESS_INFORMATION         pProcessInformation,
        [in] CorDebugCreateProcessFlags    debuggingFlags,
        [out] ICorDebugProcess             **ppProcess
    );
        
    HRESULT DebugActiveProcess (
        [in] DWORD                         id,
        [in] BOOL                          win32Attach,
        [out] ICorDebugProcess             **ppProcess
    );
        
    HRESULT EnumerateProcesses (
        [out] ICorDebugProcessEnum         **ppProcess
    );
        
    HRESULT GetProcess (
                [in] DWORD dwProcessId,
        [out] ICorDebugProcess **ppProcess);

    HRESULT Initialize();
        
    HRESULT SetManagedHandler (
        [in] ICorDebugManagedCallback      *pCallback
    );
        
    HRESULT SetUnmanagedHandler (
        [in] ICorDebugUnmanagedCallback    *pCallback
    );
        
    HRESULT Terminate ();
        
};

Métodos

Método	Descrição
Método ICorDebug::CanLaunchOrAttach	Determina se iniciar um novo processo ou anexar ao processo determinado é possível no contexto de configuração de computador e tempo de execução corrente.
Método ICorDebug::CreateProcess	Inicia um processo e seu segmento principal sob o controle do depurador.
Método ICorDebug::DebugActiveProcess	Anexa o depurador a um processo existente.
Método ICorDebug::EnumerateProcesses	Obtém um enumerador para os processos que estão sendo depurados.
Método ICorDebug::GetProcess	Retorna o ICorDebugProcess objeto com a ID de determinado processo.
Método ICorDebug::inicializar	Inicializa o ICorDebug objeto.
Método ICorDebug::SetManagedHandler	Especifica o evento manipulador de objeto para gerenciado evento s.
Método ICorDebug::SetUnmanagedHandler	Especifica o objeto do manipulador de eventos para eventos não gerenciados.
Método ICorDebug::terminar	Encerra o ICorDebug objeto.

Comentários

ICorDebug representa um loop de processamento de evento para um processo do depurador. O depurador deve aguardar o ICorDebugManagedCallback::ExitProcess retorno de chamada de todos os processos que está sendo depurado antes de liberá-lo nesta interface.

The ICorDebug é o objeto inicial para controlar a depuração gerenciada tudo ainda mais. Nas versões do .NET estrutura 1.0 e 1.1, este objeto foi um CoClass objeto criado do COM. No .NET estrutura versão 2.0, esse objeto não é mais um CoClass objeto. Ele deve ser criado pelo CreateDebuggingInterfaceFromVersion função, que é mais cientes de versão. Essa nova função de criação permite que os clientes obter uma implementação específica da ICorDebug, que emula também uma versão específica da API de depuração.

Requisitos

Plataformas: See Requisitos de sistema do .NET framework.

Cabeçalho: CorDebug.idl

Biblioteca: CorGuids.lib

.NET Framework Versions: 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

Compartilhar via