DkmLanguageInstructionAddress.CompileCondition Method

Definition

Compiles an input breakpoint condition into an inspection query which can be evaluated on the target computer. If the breakpoint condition uses DkmBreakpointConditionOperator.BreakWhenTrue, the expression evaluator should require that the specified condition evaluates to a Boolean value. The created query must return only a single result. For BreakWhenTrue conditions, this must be either a 4-byte or 1-byte value, and any non-zero value is considered true.

Location constraint: API must be called from an IDE component (component level > 100,000).

public:
 Microsoft::VisualStudio::Debugger::Evaluation::DkmCompiledInspectionQuery ^ CompileCondition(Microsoft::VisualStudio::Debugger::Breakpoints::DkmBreakpointCondition ^ Condition, [Runtime::InteropServices::Out] System::String ^ % ErrorText);
public Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery CompileCondition (Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition Condition, out string ErrorText);
member this.CompileCondition : Microsoft.VisualStudio.Debugger.Breakpoints.DkmBreakpointCondition * string -> Microsoft.VisualStudio.Debugger.Evaluation.DkmCompiledInspectionQuery
Public Function CompileCondition (Condition As DkmBreakpointCondition, ByRef ErrorText As String) As DkmCompiledInspectionQuery

Parameters

Condition
DkmBreakpointCondition

[In] Breakpoint condition to compile.

ErrorText
String

[Out,Optional] If the compilation failed, this indicates the reason why. This value should be null if the compile succeeded. If the compile does fail, S_FALSE is returned (native code only).

Returns

[Out,Optional] The result of the compilation. This is null in the case that the compilation failed. In this case, ErrorText should indicate the reason for the failure.

Applies to