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

Article
02/06/2025

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.

Retourner le code	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.