ICorDebugProcess2::SetUnmanagedBreakpoint Method

  • Article

Sets an unmanaged breakpoint at the specified native image offset.

Syntax

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: See System Requirements.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 2.0