Metodo IDebugControl3::SetNextEventIndex (dbgeng.h)

Articolo
02/06/2025

Il metodo SetNextEventIndex imposta l'evento successivo per la destinazione corrente selezionando l'evento dall'elenco statico di eventi per la destinazione, se tale elenco esiste.

Sintassi

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

Parametri

[in] Relation

Specifica come interpretare Valore quando si imposta l'indice dell'evento successivo. I valori possibili sono: DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END e DEBUG_EINDEX_FROM_CURRENT.

[in] Value

Specifica l'indice dell'evento successivo rispetto al primo, all'ultimo o all'evento corrente. L'interpretazione di Valore dipende dal valore di Relation, come indicato di seguito.

Valore di Relation	Indice eventi successivo
DEBUG_EINDEX_FROM_START	Valore.
DEBUG_EINDEX_FROM_END	Numero di eventi meno Valore.
DEBUG_EINDEX_FROM_CURRENT	Indice dell'evento corrente più Value.

L'indice risultante deve essere maggiore di zero e uno minore del numero di eventi restituiti da GetNumberEvents.

[out] NextIndex

Riceve l'indice dell'evento successivo. Se NextIndex è NULL, queste informazioni non vengono restituite.

Valore restituito

Questo metodo può anche restituire valori di errore. Per altri dettagli, vedere valori restituiti.

Codice restituito	Descrizione
S_OK	Il metodo ha avuto esito positivo.

Osservazioni

Se l'evento specificato è uguale all'evento corrente, questo metodo non esegue alcuna operazione. In caso contrario, questo metodo imposta lo stato di esecuzione della destinazione su DEBUG_STATUS_GO (e invia una notifica ai callback dell'evento). Quando viene chiamato il WaitForEvent, il motore genererà l'evento specificato per i callback dell'evento e lo imposta come evento corrente.

Questo metodo è utile solo se la destinazione offre un elenco di eventi.