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

Artículo
02/23/2024

El método SetScope establece el ámbito actual.

Sintaxis

HRESULT SetScope(
  [in]           ULONG64            InstructionOffset,
  [in, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [in, optional] PVOID              ScopeContext,
  [in]           ULONG              ScopeContextSize
);

Parámetros

[in] InstructionOffset

Especifica la ubicación en el espacio de direcciones virtuales del proceso para la instrucción actual del ámbito. Esto solo se usa si ScopeFrame y ScopeContext son NULL; de lo contrario, se omite.

[in, optional] ScopeFrame

Especifica el marco de pila del ámbito. Para obtener información sobre esta estructura, consulte DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Especifica el contexto del subproceso del ámbito. El tipo del contexto de subproceso es la estructura CONTEXT del procesador efectivo del destino. El búfer ScopeContext debe ser lo suficientemente grande como para contener esta estructura. Si ScopeContext es NULL, se usa el contexto de registro actual en su lugar.

[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	El ámbito identificado por InstructionOffset, ScopeFrame y ScopeContext es el mismo que el ámbito anterior.
S_FALSE	El ámbito ha cambiado.

Comentarios

Si solo se proporciona InstructionOffset , el ámbito se puede usar para buscar nombres de símbolos; sin embargo, los valores de estos símbolos no estarán disponibles.

Para establecer el ámbito en un estado anterior, debe proporcionarse ScopeContext . Esto no siempre es necesario (por ejemplo, si solo desea acceder a los símbolos y no a los registros). Para establecer el ámbito en un marco de la pila actual, se puede usar SetScopeFrameByIndex .

Para obtener más información sobre los ámbitos, vea Ámbitos y grupos de símbolos.