Méthode IDebugSymbols ::GetScope (dbgeng.h)

Article
02/23/2024

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