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

  • Artigo

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.

Retornar valor

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

Requisito Valor
Plataforma de Destino Área de Trabalho
Cabeçalho dbgeng.h (inclua Dbgeng.h, Ntddk.h)

Confira também

IDebugControl::GetEffectiveProcessorType

IDebugSymbols

IDebugSymbols2

IDebugSymbols3

ResetScope

SetScope