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

O método GetScope retorna informações sobre o escopo atual.

Sintaxe

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

Parâmetros

[out, optional] InstructionOffset

Recebe o local no espaço de endereço virtual do processo da instrução atual do escopo atual.

[out, optional] ScopeFrame

Recebe a estrutura DEBUG_STACK_FRAME que representa o quadro de pilha do escopo atual.

[out, optional] ScopeContext

Recebe o contexto de thread do escopo atual. O tipo do contexto de thread é a estrutura CONTEXT para o processador efetivo do destino. O buffer ScopeContext deve ser grande o suficiente para manter essa estrutura.

[in] ScopeContextSize

Especifica o tamanho do buffer ScopeContext.

Valor retornado

Esse método também pode retornar valores de erro. Consulte Valores retornados para obter mais detalhes.

Código de retorno Descrição
S_OK
O método foi bem-sucedido.
E_INVALIDARG
O tamanho do buffer ScopeContext não era grande o suficiente para manter o contexto do escopo.

Comentários

Para obter mais informações sobre escopos, consulte Escopos e Grupos de Símbolos.

Requisitos

   
Plataforma de Destino Desktop
Cabeçalho dbgeng.h (include Dbgeng.h, Ntddk.h)

Confira também

IDebugControl::GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope