DkmRuntimeBreakpoint.Enable Methode

Definition

Überlädt

Enable(DkmWorkList, DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>)

Aktiviert einen Haltepunkt. Haltepunkte beginnen anfänglich deaktiviert, sodass diese Methode aufgerufen werden muss, bevor der Breakpoint festgelegt werden kann. Das Aktivieren eines Breakpoints wird in der Regel im Debugmonitor durch Ändern des Status des Ziel Prozesses implementiert. Fügen Sie z. b. eine ' int3 '-Anweisung in den Codestream ein. Wenn der Breakpoint bereits aktiviert ist, hat dieser Vorgang keine Auswirkung.

Nachdem ein Haltepunkt aktiviert wurde, löst der Debugmonitor ein runtimebreakpoint-Ereignis für dieses dkmruntimebreakpoint-Objekt aus, wenn die Auslöserbedingung (z. h. die Ziel Anweisung) erfüllt ist. Mehrere dkmruntimebreakpoints können für dieselbe Anweisung festgelegt werden. In diesem Fall gibt der Debug-Monitor für jedes Breakpoint-Objekt ein anderes runtimebreakpoint-Ereignis aus. Entsprechend führt der Debug-Monitor beide Ereignisse aus, wenn ein Schritt beendet und ein Haltepunkt in derselben Anweisung ausgeführt wird.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

Enable()

Aktiviert einen Haltepunkt. Haltepunkte beginnen anfänglich deaktiviert, sodass diese Methode aufgerufen werden muss, bevor der Breakpoint festgelegt werden kann. Das Aktivieren eines Breakpoints wird in der Regel im Debugmonitor durch Ändern des Status des Ziel Prozesses implementiert. Fügen Sie z. b. eine ' int3 '-Anweisung in den Codestream ein. Wenn der Breakpoint bereits aktiviert ist, hat dieser Vorgang keine Auswirkung.

Nachdem ein Haltepunkt aktiviert wurde, löst der Debugmonitor ein runtimebreakpoint-Ereignis für dieses dkmruntimebreakpoint-Objekt aus, wenn die Auslöserbedingung (z. h. die Ziel Anweisung) erfüllt ist. Mehrere dkmruntimebreakpoints können für dieselbe Anweisung festgelegt werden. In diesem Fall gibt der Debug-Monitor für jedes Breakpoint-Objekt ein anderes runtimebreakpoint-Ereignis aus. Entsprechend führt der Debug-Monitor beide Ereignisse aus, wenn ein Schritt beendet und ein Haltepunkt in derselben Anweisung ausgeführt wird.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

Enable(DkmWorkList, DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>)

Aktiviert einen Haltepunkt. Haltepunkte beginnen anfänglich deaktiviert, sodass diese Methode aufgerufen werden muss, bevor der Breakpoint festgelegt werden kann. Das Aktivieren eines Breakpoints wird in der Regel im Debugmonitor durch Ändern des Status des Ziel Prozesses implementiert. Fügen Sie z. b. eine ' int3 '-Anweisung in den Codestream ein. Wenn der Breakpoint bereits aktiviert ist, hat dieser Vorgang keine Auswirkung.

Nachdem ein Haltepunkt aktiviert wurde, löst der Debugmonitor ein runtimebreakpoint-Ereignis für dieses dkmruntimebreakpoint-Objekt aus, wenn die Auslöserbedingung (z. h. die Ziel Anweisung) erfüllt ist. Mehrere dkmruntimebreakpoints können für dieselbe Anweisung festgelegt werden. In diesem Fall gibt der Debug-Monitor für jedes Breakpoint-Objekt ein anderes runtimebreakpoint-Ereignis aus. Entsprechend führt der Debug-Monitor beide Ereignisse aus, wenn ein Schritt beendet und ein Haltepunkt in derselben Anweisung ausgeführt wird.

Diese Methode fügt ein neues Arbeits Element an die angegebene Arbeitsliste an und gibt zurück, nachdem das Arbeits Element angefügt wurde. Die tatsächliche Verarbeitung der Arbeitsaufgabe erfolgt asynchron. Der Aufrufer wird benachrichtigt, dass die Anforderung durch die Abschluss Routine abgeschlossen wurde.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

public:
 void Enable(Microsoft::VisualStudio::Debugger::DkmWorkList ^ WorkList, Microsoft::VisualStudio::Debugger::DkmCompletionRoutine<Microsoft::VisualStudio::Debugger::Breakpoints::DkmEnableRuntimeBreakpointAsyncResult> ^ CompletionRoutine);
public void Enable (Microsoft.VisualStudio.Debugger.DkmWorkList WorkList, Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmEnableRuntimeBreakpointAsyncResult> CompletionRoutine);
member this.Enable : Microsoft.VisualStudio.Debugger.DkmWorkList * Microsoft.VisualStudio.Debugger.DkmCompletionRoutine<Microsoft.VisualStudio.Debugger.Breakpoints.DkmEnableRuntimeBreakpointAsyncResult> -> unit
Public Sub Enable (WorkList As DkmWorkList, CompletionRoutine As DkmCompletionRoutine(Of DkmEnableRuntimeBreakpointAsyncResult))

Parameter

WorkList
DkmWorkList

Worklist, an das das neue Arbeits Element angefügt werden soll.

CompletionRoutine
DkmCompletionRoutine<DkmEnableRuntimeBreakpointAsyncResult>

Die Routine, die nach Abschluss der Anforderung ausgelöst werden soll. Wenn die Anforderung erfolgreich an die Arbeitsliste angehängt wird, wird diese immer ausgelöst (auch wenn der Vorgang abgebrochen wird). Dies wird nie ausgelöst, wenn das Anfügen der Arbeitsaufgabe fehlschlägt.

Gilt für

Enable()

Aktiviert einen Haltepunkt. Haltepunkte beginnen anfänglich deaktiviert, sodass diese Methode aufgerufen werden muss, bevor der Breakpoint festgelegt werden kann. Das Aktivieren eines Breakpoints wird in der Regel im Debugmonitor durch Ändern des Status des Ziel Prozesses implementiert. Fügen Sie z. b. eine ' int3 '-Anweisung in den Codestream ein. Wenn der Breakpoint bereits aktiviert ist, hat dieser Vorgang keine Auswirkung.

Nachdem ein Haltepunkt aktiviert wurde, löst der Debugmonitor ein runtimebreakpoint-Ereignis für dieses dkmruntimebreakpoint-Objekt aus, wenn die Auslöserbedingung (z. h. die Ziel Anweisung) erfüllt ist. Mehrere dkmruntimebreakpoints können für dieselbe Anweisung festgelegt werden. In diesem Fall gibt der Debug-Monitor für jedes Breakpoint-Objekt ein anderes runtimebreakpoint-Ereignis aus. Entsprechend führt der Debug-Monitor beide Ereignisse aus, wenn ein Schritt beendet und ein Haltepunkt in derselben Anweisung ausgeführt wird.

Diese Methode kann nur von der Komponente aufgerufen werden, die das Objekt erstellt hat.

public:
 void Enable();
public:
 void Enable();
void Enable();
public void Enable ();
member this.Enable : unit -> unit
Public Sub Enable ()

Ausnahmen

E_RUNTIME_BREAKPOINT_ERROR gibt an, dass ein Fehler in einer Monitor Komponente aufgetreten ist, während der Lauf Zeit Haltepunkt aktiviert wurde und dass die Überwachungskomponente eine Fehlermeldung über idkmdatabreakpointerrorinfoclient. OnError bereitgestellt hat.

Gilt für