ICorDebugCode Interface

  • Article

Represents a segment of either Microsoft intermediate language (MSIL) code or native code.

interface ICorDebugCode : IUnknown {
    HRESULT CreateBreakpoint (
        [in] ULONG32     offset,
        [out] ICorDebugFunctionBreakpoint **ppBreakpoint
    );
        
    HRESULT GetAddress (
        [out] CORDB_ADDRESS *pStart
    );
        
    HRESULT GetCode (
        [in] ULONG32     startOffset, 
        [in] ULONG32     endOffset,
        [in] ULONG32     cBufferAlloc,
        [out, size_is(cBufferAlloc),
            length_is(*pcBufferSize)] BYTE buffer[],
        [out] ULONG32    *pcBufferSize
    );
        
    //
      // GetEnCRemapSequencePoints is not implemented.
    //
    HRESULT GetEnCRemapSequencePoints (
        [in] ULONG32     cMap,
        [out] ULONG32    *pcMap,
        [out, size_is(cMap), length_is(*pcMap)]
            ULONG32      offsets[]
    );
        
    HRESULT GetFunction (
        [out] ICorDebugFunction **ppFunction
    );
        
    HRESULT GetILToNativeMapping (
        [in] ULONG32     cMap,
        [out] ULONG32    *pcMap,
        [out, size_is(cMap), length_is(*pcMap)]
            COR_DEBUG_IL_TO_NATIVE_MAP map[]
    );
        
    HRESULT GetSize (
        [out] ULONG32    *pcBytes
    );
        
    HRESULT GetVersionNumber (
        [out] ULONG32    *nVersion
    );
        
    HRESULT IsIL (
        [out] BOOL       *pbIL
    );
};

Methods

Method

Description

ICorDebugCode::CreateBreakpoint Method

Creates a breakpoint at the specified offset.

ICorDebugCode::GetAddress Method

Gets the relative virtual address (RVA) of the code segment that this ICorDebugCode represents.

ICorDebugCode::GetCode Method

Gets all the code for the specified function, formatted for disassembly. This method has been deprecated in the .NET Framework version 2.0. Use ICorDebugCode2::GetCodeChunks instead.

ICorDebugCode::GetEnCRemapSequencePoints Method

Not implemented.

ICorDebugCode::GetFunction Method

Gets the ICorDebugFunction associated with this ICorDebugCode.

ICorDebugCode::GetILToNativeMapping Method

Gets an array of COR_DEBUG_IL_TO_NATIVE_MAP instances that represent mappings from MSIL offsets to native offsets.

ICorDebugCode::GetSize Method

Gets the size, in bytes, of the binary code represented by this ICorDebugCode.

ICorDebugCode::GetVersionNumber Method

Gets the one-based number that identifies the version of the code that this ICorDebugCode represents.

ICorDebugCode::IsIL Method

Gets a value that indicates whether this ICorDebugCode is compiled in MSIL.

Remarks

There is a one-to-one relationship between an ICorDebugCode object and an ICorDebugFunction object. In other words, there is one instance of ICorDebugCode for each instance of ICorDebugFunction.

Requirements

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

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0, 1.1, 1.0

See Also

Concepts

ICorDebugCode2 Interface

Debugging Interfaces