IDebugControl3::SetNextEventIndex-Methode (dbgeng.h)

Artikel
02/23/2024

Die SetNextEventIndex-Methode legt das nächste Ereignis für das aktuelle Ziel fest, indem das Ereignis aus der statischen Liste der Ereignisse für das Ziel ausgewählt wird, sofern eine solche Liste vorhanden ist.

Syntax

HRESULT SetNextEventIndex(
  [in]  ULONG  Relation,
  [in]  ULONG  Value,
  [out] PULONG NextIndex
);

Parameter

[in] Relation

Gibt an, wie Value beim Festlegen des Index des nächsten Ereignisses interpretiert wird. Mögliche Werte sind: DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END und DEBUG_EINDEX_FROM_CURRENT.

[in] Value

Gibt den Index des nächsten Ereignisses relativ zum ersten, letzten oder aktuellen Ereignis an. Die Interpretation von Value hängt wie folgt vom Wert von Relation ab.

Wert der Beziehung	Nächster Ereignisindex
DEBUG_EINDEX_FROM_START	Wert.
DEBUG_EINDEX_FROM_END	Anzahl der Ereignisse abzüglich Wert.
DEBUG_EINDEX_FROM_CURRENT	Der aktuelle Ereignisindex plus Value.

Der resultierende Index muss größer als 0 (null) und eins kleiner als die Anzahl der von GetNumberEvents zurückgegebenen Ereignisse sein.

[out] NextIndex

Empfängt den Index des nächsten Ereignisses. Wenn NextIndexNULL ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Wenn das angegebene Ereignis mit dem aktuellen Ereignis identisch ist, bewirkt diese Methode nichts. Andernfalls legt diese Methode die Ausführung status des Ziels auf DEBUG_STATUS_GO fest (und benachrichtigt die Ereignisrückrufe). Wenn WaitForEvent aufgerufen wird, generiert die Engine das angegebene Ereignis für die Ereignisrückrufe und legt es als aktuelles Ereignis fest.

Diese Methode ist nur nützlich, wenn das Ziel eine Liste von Ereignissen bietet.