Méthode IDebugEventCallbacksWide ::ChangeSymbolState (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é 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 IDebugEventCallbacksWide 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 IDebugEventCallbacksWide ::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) |
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour