DkmEvaluationResult.GetChildren Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets an enumeration context used to obtain the children of this evaluation result. This is used in all expression evaluation windows.
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 GetChildren(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, int InitialRequestSize, Microsoft::VisualStudio::Debugger::Evaluation::DkmInspectionContext ^ InspectionContext, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Evaluation::DkmGetChildrenAsyncResult> ^ CompletionRoutine);public void GetChildren (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, int InitialRequestSize, Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext InspectionContext, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmGetChildrenAsyncResult> CompletionRoutine);member this.GetChildren : Microsoft.VisualStudio.Debugger.DkmWorkList * int * Microsoft.VisualStudio.Debugger.Evaluation.DkmInspectionContext * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Evaluation.DkmGetChildrenAsyncResult> -> unitPublic Sub GetChildren (WorkList As DkmWorkList, InitialRequestSize As Integer, InspectionContext As DkmInspectionContext, CompletionRoutine As DkmCompletionRoutine(Of DkmGetChildrenAsyncResult))Parameters
- WorkList
- DkmWorkList
WorkList to append the new work item to.
- InitialRequestSize
- Int32
[In] The initial number of children that the caller would like returned. This value can be zero if no children will be initially returned. This value may be larger than the number of children that this expression has, in which case all children 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.
- InspectionContext
- DkmInspectionContext
[In] The inspection context to use for computing the children. This may differ from the original inspection context with respect to settings, such as radix, evaluation flags, or timeout.
- CompletionRoutine
- DkmCompletionRoutine<DkmGetChildrenAsyncResult>
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.