IDebugControl3 ::SetNextEventIndex, méthode (dbgeng.h)

Article
02/06/2025

La méthode SetNextEventIndex définit l’événement suivant pour la cible actuelle en sélectionnant l’événement dans la liste statique d’é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 valeur lors de la définition de l’index de l’événement suivant. Les valeurs possibles sont les suivantes : 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 événement actuel. L’interprétation de valeur dépend de la valeur de Relation, comme suit.

Valeur de relation	Index d’événement suivant
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 est NULL, ces informations ne sont pas retournées.

Valeur de retour

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

Retourner le code	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 l’état d’exécution de la cible sur DEBUG_STATUS_GO (et avertit 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 est utile uniquement si la cible propose une liste d’événements.