Méthode IDebugControl3 ::SetNextEventIndex (dbgeng.h)

Article
02/23/2024

La méthode SetNextEventIndex définit l’événement suivant pour la cible actuelle en sélectionnant l’événement dans la liste statique des événements de la cible, s’il existe une telle liste.

Syntaxe

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

Paramètres

[in] Relation

Spécifie comment interpréter value lors de la définition de l’index de l’événement suivant. Les valeurs possibles sont : DEBUG_EINDEX_FROM_START, DEBUG_EINDEX_FROM_END et DEBUG_EINDEX_FROM_CURRENT.

[in] Value

Spécifie l’index de l’événement suivant par rapport au premier, dernier ou actuel événement. L’interprétation de Value dépend de la valeur de Relation, comme suit.

Valeur de relation	Next Event Index
DEBUG_EINDEX_FROM_START	Valeur.
DEBUG_EINDEX_FROM_END	Nombre d’événements moins Valeur.
DEBUG_EINDEX_FROM_CURRENT	Index d’événement actuel plus Valeur.

L’index résultant doit être supérieur à zéro et un inférieur au nombre d’événements retournés par GetNumberEvents.

[out] NextIndex

Reçoit l’index de l’événement suivant. Si NextIndex a la valeur NULL, ces informations ne sont pas retournées.

Valeur retournée

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez Valeurs de retour.

Code de retour	Description
S_OK	La méthode a réussi.

Remarques

Si l’événement spécifié est identique à l’événement actuel, cette méthode ne fait rien. Sinon, cette méthode définit la status d’exécution de la cible sur DEBUG_STATUS_GO (et notifie les rappels d’événements). Lorsque WaitForEvent est appelé, le moteur génère l’événement spécifié pour les rappels d’événements et le définit comme événement actuel.

Cette méthode n’est utile que si la cible propose une liste d’événements.