Méthode IDebugSymbols2 ::GetScopeSymbolGroup (dbgeng.h)

Article
02/23/2024

La méthode GetScopeSymbolGroup renvoie un groupe de symboles contenant les symboles dans l’étendue de la cible actuelle.

Syntaxe

HRESULT GetScopeSymbolGroup(
  [in]           ULONG               Flags,
  [in, optional] PDEBUG_SYMBOL_GROUP Update,
  [out]          PDEBUG_SYMBOL_GROUP *Symbols
);

Paramètres

[in] Flags

Spécifie un jeu de bits utilisé pour déterminer les symboles à inclure dans le groupe de symboles. Pour inclure tous les symboles, définissez Indicateurs sur DEBUG_SCOPE_GROUP_ALL. Les indicateurs de bits suivants déterminent les symboles inclus.

Indicateur	Description
DEBUG_SCOPE_GROUP_ARGUMENTS	Incluez les arguments de fonction pour l’étendue actuelle.
DEBUG_SCOPE_GROUP_LOCALS	Incluez les variables locales pour l’étendue actuelle.

[in, optional] Update

Spécifie un groupe de symboles créé précédemment qui sera mis à jour pour refléter l’étendue actuelle. Si Update a la valeur NULL, un nouvel objet d’interface de groupe de symboles est créé.

[out] Symbols

Reçoit l’objet d’interface de groupe de symboles pour l’étendue actuelle. Pour plus d’informations sur cette interface, consultez IDebugSymbolGroup

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

Le paramètre Update permet des mises à jour efficaces lors de l’exécution pas à pas du code. Au lieu de créer et de remplir un nouveau groupe de symboles, l’ancien groupe de symboles peut être mis à jour.

Pour plus d’informations sur les étendues et les groupes de symboles, consultez Étendues et groupes de symboles.