ICorDebugProcess2 Interface

Article
03/30/2009

A logical extension of the ICorDebugProcess interface, which represents a process running managed code.

interface ICorDebugProcess2 : IUnknown {
        
    HRESULT ClearUnmanagedBreakpoint (
        [in] CORDB_ADDRESS             address
    );
        
    HRESULT GetDesiredNGENCompilerFlags (
        [out] DWORD                    *pdwFlags
    );
        
    HRESULT GetReferenceValueFromGCHandle (
        [in] UINT_PTR                  handle,
        [out] ICorDebugReferenceValue  **pOutValue
    );
        
    HRESULT GetThreadForTaskID (
        [in] TASKID                    taskid,
        [out] ICorDebugThread2         **ppThread
    );
        
    HRESULT GetVersion (
        [out] COR_VERSION*             version
    );
        
    HRESULT SetDesiredNGENCompilerFlags (
                [in] DWORD                     pdwFlags
    );
        
    HRESULT SetUnmanagedBreakpoint (
                [in] CORDB_ADDRESS             address,
        [in] ULONG32                   bufsize,
        [out, size_is(bufsize), length_is(*bufLen)] 
            BYTE                       buffer[],
        [out] ULONG32                  *bufLen
    );
        
};

Methods

Method	Description
ICorDebugProcess2::ClearUnmanagedBreakpoint Method	Removes a breakpoint at the specified offset that was set by an earlier call to ICorDebugProcess2::SetUnmanagedBreakpoint.
ICorDebugProcess2::GetDesiredNGENCompilerFlags Method	Gets the flags that must be set for the common language runtime (CLR) to load the image into the process referenced by this ICorDebugProcess2.
ICorDebugProcess2::GetReferenceValueFromGCHandle Method	Gets a reference pointer to the specified managed object that has a garbage collection handle.
ICorDebugProcess2::GetThreadForTaskID Method	Gets the thread upon which the task with the specified identifier is executing.
ICorDebugProcess2::GetVersion Method	Gets the version of the CLR upon which the process being debugged is running.
ICorDebugProcess2::SetDesiredNGENCompilerFlags Method	Sets the flags that are required for the just-in-time (JIT) compiler to load an image into the process being debugged.
ICorDebugProcess2::SetUnmanagedBreakpoint Method	Sets an unmanaged breakpoint at the specified native image offset.

Requirements

Platforms: Windows 2000, Windows XP, Windows Server 2003 family

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

ICorDebugProcess2 Interface

Methods

Requirements

See Also

Concepts

Additional resources