IDebugControl3::SetNextEventIndex-Methode (dbgeng.h)

Artikel
02/06/2025

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, wenn eine solche Liste vorhanden ist.

Syntax

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

Parameter

[in] Relation

Gibt an, wie Value interpretiert wird, wenn der Index des nächsten Ereignisses festgelegt 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 Wert hängt von dem Wert Relationwie folgt ab.

Wert Relation	Nächster Ereignisindex
DEBUG_EINDEX_FROM_START	Wert.
DEBUG_EINDEX_FROM_END	Anzahl der Ereignisse minus Value.
DEBUG_EINDEX_FROM_CURRENT	Der aktuelle Ereignisindex plus Value.

Der resultierende Index muss größer als 0 und eine kleiner als die Anzahl der ereignisse sein, die von GetNumberEventszurückgegeben werden.

[out] NextIndex

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

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Wenn das angegebene Ereignis mit dem aktuellen Ereignis identisch ist, führt diese Methode nichts aus. Andernfalls legt diese Methode den Ausführungsstatus des Ziels auf DEBUG_STATUS_GO fest (und benachrichtigt die Ereignisrückrufe). Wenn WaitForEvent- aufgerufen wird, generiert das Modul 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.