IDebugEventCallbacks::ChangeSymbolState, méthode (dbgeng.h)

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é certains 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 L’image exécutable, la source ou les chemins de recherche de symboles ont changé.
DEBUG_CSS_SYMBOL_OPTIONS Les options de symboles 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 Indicateurs , le paramètre Argument n’est pas utilisé. Sinon, la valeur de l’argument dépend de la valeur des indicateurs :

DEBUG_CSS_LOADS

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

DEBUG_CSS_UNLOADS

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

DEBUG_CSS_SCOPE

La valeur de l’argument est égale à zéro.

DEBUG_CSS_PATHS

La valeur de l’argument est égale à zéro.

DEBUG_CSS_SYMBOL_OPTIONS

La valeur de l’argument est les options de symboles.

DEBUG_CSS_TYPE_OPTIONS

La valeur de l’argument est égale à zéro.

Valeur de retour

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 est appelée uniquement par le moteur 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

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h)