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.
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 |
|---|---|
|
O método foi bem-sucedido. |
|
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) |