Microsoft SDK for Java

IRemoteObject::
SetBreakpoint

The SetBreakpoint method of the IRemoteObject interface sets a data breakpoint on this object. If the data breakpoint is hit, the Microsoft VM will call the debugger's IRemoteProcessCallbackEx2::DataBreakpointEvent method.

Syntax

HRESULT SetBreakpoint(void)

Return Value

S_OK Success.

E_FAIL Unable to set a data breakpoint on this object.

E_TOOMANYBREAKPOINTS The maximum number of data breakpoints of the type required by this object's location have already been set. For example, if page breakpoints are disabled and the maximum number of hardware breakpoints supported by the processor architecture has already been used, this error code will be returned. Breakpoints in stack frame objects (local variables) are restricted to hardware breakpoints. This error might be returned even if page breakpoints are enabled.

E_OUTOFMEMORY Insufficient memory.

Remarks

For a primitive variable, the value of the variable changes when the variable is assigned a value. For an object reference variable, the value of the variable changes when the variable references a different instance of that class, not when any of the instance's data members change. For an array variable, the value of the variable changes when the variable references a different array, not when any of the array's elements change.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.