DkmEvaluationResultEnumContext.GetItems Method

Definition

Obtain DkmEvaluationResult items from this enumeration context. This is used to obtain local variables of a stack frame or child members from an evaluation result.

This method will append a new work item to the specified work list, and return once the work item has been appended. The actual processing of the work item is asynchronous. The caller will be notified that the request is complete through the completion routine.

Location constraint: IDE components may call this method regardless of what type of code is being debugged. This method is also currently supported for debug monitor components, when debugging code running under the CLR; however this functionality may be removed in a future version.

public:
 void GetItems(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, int StartIndex, int Count, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Evaluation::DkmEvaluationEnumAsyncResult> ^ CompletionRoutine);
public void GetItems (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, int StartIndex, int Count, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationEnumAsyncResult> CompletionRoutine);
member this.GetItems : Microsoft.VisualStudio.Debugger.DkmWorkList * int * int * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmEvaluationEnumAsyncResult> -> unit
Public Sub GetItems (WorkList As DkmWorkList, StartIndex As Integer, Count As Integer, CompletionRoutine As DkmCompletionRoutine(Of DkmEvaluationEnumAsyncResult))

Parameters

WorkList
DkmWorkList

WorkList to append the new work item to.

StartIndex
Int32

[In] The zero-based index of the first item to obtain.

Count
Int32

[In] The number of items to try and return. This value may be larger than the total number of remaining items, in which case all remaining items should be returned. Very large or negative values should not be used as arrays can have extremely large sizes which would cause out-of-memory if all elements were requested.

CompletionRoutine
DkmCompletionRoutine<DkmEvaluationEnumAsyncResult>

Routine to fire when the request is complete. If the request is successfully appended to the work list, this will always fire (including when the operation is canceled). This will never fire if appending the work item fails.

Applies to