Método IDebugHost::GetCurrentContext (dbgmodel.h)
O método GetCurrentContext retorna uma interface que representa o estado atual do host do depurador. O significado exato disso é deixado para o host, mas normalmente inclui itens como a sessão, o processo e o espaço de endereço que está ativo na interface do usuário do host de depuração. O objeto de contexto retornado é amplamente opaco para o chamador, mas é um objeto importante para passar entre chamadas para o host de depuração. Quando um chamador está, por exemplo, lendo memória, é importante saber de qual processo e espaço de endereço a memória está sendo lida. Essa noção é encapsulada na noção do objeto de contexto que é retornado desse método.
Opcionalmente, cada objeto e símbolo no modelo de dados tem informações de contexto como esta associadas a ele. Também é comum que o contexto seja passado de um objeto para novos objetos criados como propriedades dos existentes. Esses objetos criados pelo próprio host de depuração podem fazer com que informações de contexto adicionais sejam inseridas no objeto retornado (por exemplo: a propriedade Stack de um thread pode inserir informações sobre a qual thread a pilha se refere dentro do contexto).
Sintaxe
HRESULT GetCurrentContext(
IDebugHostContext **context
);
Parâmetros
context
Um objeto que representa o contexto atual do host é retornado aqui.
Retornar valor
Esse método retorna HRESULT que indica êxito ou falha. Um host que não tem um conceito de informações de contexto pode retornar E_NOTIMPL aqui.
Comentários
Exemplo de código
ComPtr<IDebugHost> spHost; /* get the debug host */
ComPtr<IDebugHostContext> spContext;
if (SUCCEEDED(spHost->GetCurrentContext(&spContext)))
{
// spContext now contains an opaque object representing the current UI
// state of the debugger (e.g.: what session/process/thread the debug UI
// is focused on)
}
Requisitos
| Requisito | Valor |
|---|---|
| Cabeçalho | dbgmodel.h |