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

La méthode GetScope retourne des informations sur l’étendue actuelle.

Syntaxe

HRESULT GetScope(
  [out, optional] PULONG64           InstructionOffset,
  [out, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [out, optional] PVOID              ScopeContext,
  [in]            ULONG              ScopeContextSize
);

Paramètres

[out, optional] InstructionOffset

Reçoit l’emplacement dans l’espace d’adressage virtuel du processus de l’instruction actuelle de l’étendue actuelle.

[out, optional] ScopeFrame

Reçoit la structure DEBUG_STACK_FRAME représentant le cadre de pile de l’étendue actuelle.

[out, optional] ScopeContext

Reçoit le contexte de thread de l’étendue actuelle. Le type du contexte de thread est la structure CONTEXT du processeur effectif de la cible. La mémoire tampon ScopeContext doit être suffisamment grande pour contenir cette structure.

[in] ScopeContextSize

Spécifie la taille de la mémoire tampon ScopeContext.

Valeur de retour

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.
E_INVALIDARG
La taille de la mémoire tampon ScopeContext n’était pas suffisamment grande pour contenir le contexte de l’étendue.

Remarques

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

Configuration requise

   
Plateforme cible Desktop (Expérience utilisateur)
En-tête dbgeng.h (include Dbgeng.h, Ntddk.h)

Voir aussi

IDebugControl::GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope