Partilhar via


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

O método SetScopeFrameByIndex define o escopo atual para 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, que representa a chamada atual, tem índice zero.

Valor de retorno

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

Código de retorno Descrição
S_OK
O método foi bem-sucedido.

Observações

Quando um evento ocorre e o mecanismo 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 Índice 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.

Requisitos

Requisito Valor
da Plataforma de Destino Área de trabalho
cabeçalho dbgeng.h (inclua Dbgeng.h)

Consulte também

.frame (Definir Contexto Local)

GetCurrentScopeFrameIndex

IDebugSymbols3

SetScope

SetScopeFromStoredEvent