DkmManagedHeapWalker.GetPathsToRoot Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Ruft die Pfade zum Stamm für das angegebene Objekt ab.
Diese Methode fügt ein neues Arbeitselement an die angegebene Arbeitsliste an und gibt zurück, sobald das Arbeitselement angefügt wurde. Die tatsächliche Verarbeitung des Arbeitselements erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Vervollständigungsroutine abgeschlossen ist.
Diese API wurde in Visual Studio 17 Update 2 (DkmApiVersion.VS17Update2) eingeführt.
public void GetPathsToRoot(Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, ulong ObjectAddress, bool StopOnFirstRoot, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Clr.DkmGetPathsToRootAsyncResult> CompletionRoutine);
member this.GetPathsToRoot : Microsoft.VisualStudio.Debugger.DkmWorkList * uint64 * bool * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Clr.DkmGetPathsToRootAsyncResult> -> unit
Public Sub GetPathsToRoot (WorkList As DkmWorkList, ObjectAddress As ULong, StopOnFirstRoot As Boolean, CompletionRoutine As DkmCompletionRoutine(Of DkmGetPathsToRootAsyncResult))
Parameter
- WorkList
- DkmWorkList
WorkList, an die das neue Arbeitselement angefügt werden soll.
- ObjectAddress
- UInt64
[In] Die Objektadresse.
- StopOnFirstRoot
- Boolean
[In] Um den Pfad zum ersten gefundenen Stamm abzurufen.
- CompletionRoutine
- DkmCompletionRoutine<DkmGetPathsToRootAsyncResult>
Routine, die ausgelöst werden soll, wenn die Anforderung abgeschlossen ist. Wenn die Anforderung erfolgreich an die Arbeitsliste angefügt wurde, wird diese immer ausgelöst (auch wenn der Vorgang abgebrochen wird). Dies wird nie ausgelöst, wenn beim Anfügen des Arbeitselements ein Fehler auftritt.