DkmManagedHeapWalker.GetPathsToRoot Methode

Definition

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.

Gilt für: