IDebugControl3::SetExpressionSyntaxByName method (dbgeng.h)

The SetExpressionSyntaxByName method sets the syntax that the engine will use to evaluate expressions.

Syntax

HRESULT SetExpressionSyntaxByName(
  [in] PCSTR AbbrevName
);

Parameters

[in] AbbrevName

Specifies the abbreviated name of the syntax. It can be one of the following strings:

C++

Expressions will be evaluated according to C++ syntax. For details of this syntax, see C++ Numbers and Operators.

MASM

Expressions will be evaluated according to MASM syntax. For details of this syntax, see MASM Numbers and Operators.

Return value

This method may also return error values. See Return Values for more details.

Return code Description
S_OK
The method was successful.

Remarks

The expression syntax is a global setting within the engine, so setting the expression syntax will affect all clients.

The expression syntax of the engine determines how the engine will interpret expressions passed to Evaluate, Execute, and any other method that evaluates an expression.

After the expression syntax has been changed, the engine sends out notification to the IDebugEventCallbacks callback object registered with each client. It also passes the DEBUG_CES_EXPRESSION_SYNTAX flag to the IDebugEventCallbacks::ChangeEngineState method.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include Dbgeng.h)

See also

Evaluate

GetExpressionSyntax

IDebugControl3

SetExpressionSyntax