Metodo IDebugControl3::SetNextEventIndex (dbgeng.h)

Articolo
02/25/2024

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 Value 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 Value dipende dal valore di Relation, come indicato di seguito.

Valore della relazione	Indice eventi successivo
DEBUG_EINDEX_FROM_START	Valore.
DEBUG_EINDEX_FROM_END	Numero di eventi meno Value.
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 è stato eseguito correttamente.

Commenti

Se l'evento specificato corrisponde 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 notifica i callback degli eventi). Quando viene chiamato WaitForEvent , il motore genererà l'evento specificato per i callback dell'evento e lo imposterà come evento corrente.

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