Partager via

Méthode IDebugEventCallbacks ::ChangeSymbolState (dbgeng.h)

  • Article

La méthode de rappel ChangeSymbolState est appelée par le moteur lorsque l’état du symbole change.

Syntaxe

HRESULT ChangeSymbolState(
  [in] ULONG   Flags,
  [in] ULONG64 Argument
);

Paramètres

[in] Flags

Spécifie un jeu de bits indiquant la nature de la modification de l’état du symbole. Les indicateurs de bits suivants peuvent être définis.

Valeur Description
DEBUG_CSS_LOADS Le moteur a chargé des symboles de module.
DEBUG_CSS_UNLOADS Le moteur a déchargé certains symboles de module.
DEBUG_CSS_SCOPE L’étendue du symbole actuel a changé.
DEBUG_CSS_PATHS Les chemins de recherche d’image exécutable, de source ou de symbole ont changé.
DEBUG_CSS_SYMBOL_OPTIONS Les options de symbole ont changé.
DEBUG_CSS_TYPE_OPTIONS Les options de type ont changé.

[in] Argument

Fournit des informations supplémentaires sur la modification de l’état du symbole. Si plusieurs indicateurs de bits sont définis dans le paramètre Flags , le paramètre Argument n’est pas utilisé. Sinon, la valeur de Argument dépend de la valeur des indicateurs :

DEBUG_CSS_LOADS

La valeur de Argument est l’emplacement de base (dans l’espace d’adressage mémoire de la cible) de l’image de module pour laquelle le moteur a chargé des symboles.

DEBUG_CSS_UNLOADS

La valeur de Argument est l’emplacement de base (dans l’espace d’adressage mémoire de la cible) de l’image de module pour laquelle le moteur a déchargé les symboles. Si le moteur a déchargé des symboles pour plusieurs images, la valeur de Argument est zéro.

DEBUG_CSS_SCOPE

La valeur de Argument est zéro.

DEBUG_CSS_PATHS

La valeur de Argument est zéro.

DEBUG_CSS_SYMBOL_OPTIONS

La valeur de Argument est les options de symbole.

DEBUG_CSS_TYPE_OPTIONS

La valeur de Argument est zéro.

Valeur retournée

La valeur de retour est ignorée par le moteur, sauf si elle indique une erreur d’appel de procédure distante ; dans ce cas, le client, avec lequel cet objet IDebugEventCallbacks est inscrit, est désactivé.

Remarques

Cette méthode n’est appelée par le moteur que si l’indicateur DEBUG_EVENT_CHANGE_SYMBOL_STATE est défini dans le masque retourné par IDebugEventCallbacks ::GetInterestMask.

Pour plus d’informations sur la gestion des événements, consultez Surveillance des événements.

Configuration requise

Condition requise Valeur
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (inclure Dbgeng.h)