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

Artigo
02/26/2024

O método SetScopeFrameByIndex define o escopo atual como o escopo de um dos quadros na pilha de chamadas.

Sintaxe

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Parâmetros

[in] Index

Especifica o índice do quadro de pilha do qual definir o escopo. O índice conta o número de quadros da parte superior da pilha de chamadas. O quadro na parte superior da pilha, representando a chamada atual, tem índice zero.

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.

Comentários

Quando ocorre um evento e o mecanismo do depurador é dividido em um destino, o escopo é definido como a chamada de função atual (a função que estava sendo executada quando o evento ocorreu). Chamar esse método com Index definido como um alterará o escopo atual para o chamador da função atual; com Index definido como dois, o escopo é alterado para o chamador do chamador e assim por diante.

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