SetOffsetExpression

The SetOffsetExpression and SetOffsetExpressionWide methods set an expression string that evaluates to the location that triggers a breakpoint.

HRESULT
  IDebugBreakpoint::SetOffsetExpression(
    IN PCSTR  Expression
    );

HRESULT
  IDebugBreakpoint2::SetOffsetExpressionWide(
    IN PCSTR  Expression
    );

#ifdef UNICODE
#define SetOffsetExpressionT SetOffsetExpressionWide
#else
#define SetOffsetExpressionT SetOffsetExpression
#endif

Parameters

Expression

The expression string that evaluates to the location on the target that triggers the breakpoint. If the engine icannot evaluate the expression (for example, if the expression contains a symbol that cannot be interpreted), the breakpoint is flagged as deferred. (For more information about deferred breakpoints, see Controlling Breakpoint Flags and Parameters.) For more information about the expression syntax, see Using Breakpoints.

Return Value

SetOffsetExpression and SetOffsetExpressionWide might return one of the following values:

S_OK

The method was successful.

This method might also return error values. For more information about possible return values, see Return Values.

Comments

For more information about how to use breakpoints, see Using Breakpoints.

Requirements

Versions: SetOffsetExpression is available in all versions of IDebugBreakpoint. SetOffsetExpressionWide is available in IDebugBreakpoint2 and later versions.

Headers: Defined in Dbgeng.h. Include Dbgeng.h.