Partager via


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

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.

Configuration requise

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

Voir aussi

GetScope

IDebugSymbolGroup

IDebugSymbols

IDebugSymbols2

IDebugSymbols3