Méthode IDebugSymbols3 ::SetScopeFrameByIndex (dbgeng.h)

Article
02/26/2024

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

Syntaxe

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Paramètres

[in] Index

Spécifie l’index de la trame de pile à partir de laquelle définir l’étendue. L’index compte le nombre de trames situées en haut de la pile des appels. L’image située en haut de la pile, qui représente l’appel actuel, a un index zéro.

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

Lorsqu’un événement se produit et que le moteur du débogueur s’arrête dans une cible, l’étendue est définie sur l’appel de fonction actuel (la fonction qui s’exécute lorsque l’événement s’est produit). L’appel de cette méthode avec Index défini sur un modifie l’étendue actuelle en appelant 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.