Método IDebugSymbols3::SetScope (dbgeng.h)
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, vea DEBUG_STACK_FRAME.
[in, optional] ScopeContext
Especifica el contexto de subproceso del ámbito. El tipo del contexto del 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 en su lugar el de contexto de registro de actual.
[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 información.
| Código devuelto | Descripción |
|---|---|
|
El ámbito identificado por InstructionOffset, ScopeFramey ScopeContext es el mismo que el ámbito anterior. |
|
El ámbito ha cambiado. |
Observaciones
Si solo se proporciona instrucciónOffset, se puede usar el ámbito 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, se debe proporcionar ScopeContext. Esto no siempre es necesario (por ejemplo, si solo desea tener acceso a los símbolos y no al registra). 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.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |