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

Artigo
02/23/2024

O método SetScope define o escopo atual.

Sintaxe

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

Parâmetros

[in] InstructionOffset

Especifica o local no espaço de endereço virtual do processo para a instrução atual do escopo. Isso só será usado se ScopeFrame e ScopeContext forem NULL; caso contrário, ele será ignorado.

[in, optional] ScopeFrame

Especifica o quadro de pilha do escopo. Para obter informações sobre essa estrutura, consulte DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Especifica o contexto de thread do escopo. 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. Se ScopeContext for NULL, o contexto de registro atual será usado.

[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 escopo identificado por InstructionOffset, ScopeFrame e ScopeContext é o mesmo que o escopo antigo.
S_FALSE	O escopo foi alterado.

Comentários

Se somente InstructionOffset for fornecido, o escopo poderá ser usado para pesquisar nomes de símbolos; no entanto, os valores desses símbolos não estarão disponíveis.

Para definir o escopo como um estado anterior, ScopeContext deve ser fornecido. Isso nem sempre é necessário (por exemplo, se você só deseja acessar os símbolos e não os registros). Para definir o escopo como um quadro na pilha atual, SetScopeFrameByIndex pode ser usado.

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