IDebugSymbols3 ::SetScopeFrameByIndex, méthode (dbgeng.h)

Article
02/06/2025

La méthode SetScopeFrameByIndex définit l’étendue actuelle sur l’étendue de l’une des images sur la pile des appels.

Syntaxe

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Paramètres

[in] Index

Spécifie l’index du frame de pile à partir duquel définir l’étendue. L’index compte le nombre d’images en haut de la pile des appels. Le frame situé en haut de la pile, représentant l’appel actuel, a l’index zéro.

Valeur de retour

Cette méthode peut également retourner des valeurs d’erreur. Pour plus d’informations, consultez valeurs de retour.

Retourner le code	Description
S_OK	La méthode a réussi.

Remarques

Lorsqu’un événement se produit et que le moteur de débogueur se décompose en cible, l’étendue est définie sur l’appel de fonction actuel (fonction qui s’exécute lorsque l’événement s’est produit). L’appel de cette méthode avec Index défini sur un va remplacer l’étendue actuelle par l’appelant de la fonction actuelle ; avec Index défini sur deux, l’étendue est remplacée par l’appelant de l’appelant, et ainsi de suite.

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