Share via

ICorDebugProcess2::SetUnmanagedBreakpoint Method

  • Article

Sets an unmanaged breakpoint at the specified native image offset.

HRESULT SetUnmanagedBreakpoint (
       [in]  CORDB_ADDRESS    address,
       [in]  ULONG32          bufsize,
    [out, size_is(bufsize), length_is(*bufLen)] 
           BYTE               buffer[],
       [out] ULONG32          *bufLen
);

Parameters

  • address
    [in] A CORDB_ADDRESS object that specifies the native image offset.

  • bufsize
    [in] The size, in bytes, of the buffer array.

  • buffer
    [out] An array that contains the opcode that is replaced by the breakpoint.

  • bufLen
    [out] A pointer to the number of bytes returned in the buffer array.

Remarks

If the native image offset is within the common language runtime (CLR), the breakpoint will be ignored. This allows the CLR to avoid dispatching an out-of-band breakpoint, when the breakpoint is set by the debugger.

Requirements

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

Header: CorDebug.idl

Library: CorGuids.lib

.NET Framework Version: 2.0

See Also

Concepts

ICorDebugProcess2 Interface

ICorDebugProcess Interface