DkmEvaluationResultFlags Enum

Definition

Namespace:

Microsoft.VisualStudio.Debugger.Evaluation

Assembly:

Microsoft.VisualStudio.Debugger.Engine.dll

Package:

Microsoft.VisualStudio.Debugger.Engine v17.8.1101801

Flags which indicate attributes of an expression evaluation result.

This enumeration supports a bitwise combination of its member values.

C++/CX

public enum class DkmEvaluationResultFlags

Inheritance

Enum

DkmEvaluationResultFlags

Attributes

FlagsAttribute

Fields

Name	Value	Description
None	0	No attribute flags are set.
SideEffect	1	Indicates that the evaluation caused a side effect.
Expandable	2	Indicates that the result of this evaluation has children which can be accessed through DkmEvaluationResult.GetChildren.
Boolean	4	Indicates that the result of the evaluation is a Boolean value.
BooleanTrue	8	If the Boolean flag is set, indicates that the result of the evaluation is "true", as opposed to "false".
RawString	16	Indicates that the result of the expression represents a conceptual string that can be displayed in the string viewer. The EE should be prepared to provide the raw string via IDkmLanguageExpressionEvaluator::GetUnderlyingString().
Address	32	Indicates that the result of the expression evaluation is an address that can be navigated to in the memory window.
ReadOnly	64	Indicates that the result of the expression evaluation is read-only. If false, the user will be allowed to modify the value.
ILInterpreter	128	Indicates that the IL interpreter was used to get the result of the expression evaluation.
UnflushedSideEffects	256	Indicates that the expression contains side effects that were discarded by the IL interpreter. To flush the side effects, the user should re-evaluate the expression with real func-evals turned on.
HasObjectId	512	Indicates that the expression has an object id associated with it.
CanHaveObjectId	1024	Indicates that the expression can have an object id assigned to it.
CrossThreadDependency	2048	Indicates that the expression was rejected because it has a cross thread dependency.
Invalid	4096	Indicates that the value is invalid.
Visualized	8192	Indicates that the object being inspected has a visualizer associated with it. Currently, this flag is only implemented for C++ and is set whenever the result of the evaluation has a natvis entry associated with it.
ExpandableError	16384	Indicates that the Evaluation Results was marked as an Error but has an expandable object. An example of this is the VB EE results that is an Exception object.
ExceptionThrown	32768	Indicates that the function or property being evaluated threw an exception. Not all expression evaluators set this flag.
ReturnValue	65536	Indicates that this value is the return value of a function that was called during the last step.
IsBuiltInType	131072	Indicates that the type of the value is a built-in type.
CanEvaluateNow	262144	Indicates that the UI will provide a refresh button that the user can click on to repeat the evaluation. The retry will happen with DkmEvaluationFlags::EvaluateNow set.
EnableExtendedSideEffectsUponRefresh	524288	Indicates that the formatting of this object requires additional side effects that have been suppressed; the user can redo the evaluation with these additional side effects by clicking the refresh button.
MemoryFuture	1048576	For time-travelling processes, indicates that memory had to be read from the 'future' relative to the current process time in order to evaluate an expression.
MemoryPast	2097152	For time-travelling processes, indicates that memory had to be read from the 'past' relative to the current process time in order to evaluate an expression.
MemoryGap	4194304	For time-travelling processes, indicates that there was a gap (unknown to the process) in memory used in order to evaluate an expression.
HasDataBreakpoint	8388608	Indicates that the result of the expression has an address which is currently being tracked by a data breakpoint.
CanFavorite	16777216	This evaluation result is an item which can be added as a favorite of its parent type.
IsFavorite	33554432	This evaluation result is an item which has been added as a favorite of its parent type.
HasFavorites	67108864	This evaluation result is an item whose current expansion contains at least one favorite item.
IsObjectReplaceable	134217728	If the evaluation result supports replacing the object for managed custom visualizers.
ExpansionHasSideEffects	268435456	Enumerating the children of this item will require side effects.
CanEvaluateWithoutOptimization	536870912	Indicates the variable value might be available if the target is re-launched with optimizations disabled.
TruncatedString	1073741824	When set, indicates that this result represents a string that has been truncated and the Value does not represent the full string bytes from the target. GetUnderlyingValue may be used to obtain the full string bytes.

Applies to