Método IDebugSymbols2::GetScope (dbgeng.h)

Artículo
02/23/2024

El método GetScope devuelve información sobre el ámbito actual.

Sintaxis

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

Parámetros

[out, optional] InstructionOffset

Recibe la ubicación en el espacio de direcciones virtuales del proceso de la instrucción actual del ámbito actual.

[out, optional] ScopeFrame

Recibe la estructura DEBUG_STACK_FRAME que representa el marco de pila del ámbito actual.

[out, optional] ScopeContext

Recibe el contexto del subproceso del ámbito actual. El tipo del contexto del subproceso es la estructura CONTEXT del procesador efectivo del destino. ScopeContext del búfer debe ser lo suficientemente grande como para contener esta estructura.

[in] ScopeContextSize

Especifica el tamaño del búfer ScopeContext.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
E_INVALIDARG	El tamaño del búfer ScopeContext no era lo suficientemente grande como para contener el contexto del ámbito.