Interface IDebugHostContext (dbgmodel.h)

Representa um contexto do depurador responde a perguntas sobre (sobre qual sessão, processo, thread).

Herança

IDebugHostContext herda de IUnknown.

Métodos

A interface IDebugHostContext tem esses métodos.

IDebugHostContext::AddRef O método IDebugHostContext::AddRef incrementa a contagem de referência para uma interface em um objeto .
IDebugHostContext::IsEqualTo Retorna se dois objetos IDebugHostContext são iguais por valor.
IDebugHostContext::QueryInterface O método IDebugHostContext::QueryInterface recupera ponteiros para as interfaces com suporte em um objeto .
IDebugHostContext::Release O método IDebugHostContext::Release diminui a contagem de referência para uma interface em um objeto .

Comentários

Objetos de contexto são blobs opacos de informações que o host de depuração (em cooperação com o modelo de dados) associa a cada objeto. Ele pode incluir coisas como o contexto do processo ou o espaço de endereço do qual as informações vêm, etc... Um objeto de contexto é uma implementação de IDebugHostContext em caixa em um IModelObject.

Observe que IDebugHostContext é uma interface definida pelo host. Um cliente nunca implementará essa interface.

Contexto: o espaço de endereço

É importante observar que, ao contrário dos modelos de extensão anteriores em que o contexto (o destino, o processo, o thread que você está olhando) é um conceito de interface do usuário com todas as APIs relativas ao estado atual da interface do usuário, as interfaces do modelo de dados normalmente assumem esse contexto explicitamente ou implicitamente como uma interface IDebugHostContext. Cada IModelObject dentro do modelo de dados carrega esse tipo de informação de contexto junto com ele e pode propagar esse contexto para objetos que retorna. Isso significa que, quando você ler um valor nativo ou um valor de chave de um IModelObject, ele será lido fora do destino e processará de onde o objeto foi adquirido originalmente. Há um valor constante explícito, USE_CURRENT_HOST_CONTEXT, que pode ser passado para métodos que levam um argumento IDebugHostContext. Esse valor indica que o contexto deve ser, de fato, o estado atual da interface do usuário do depurador. No entanto, essa noção precisa ser explícita.

Requisitos

Requisito	Valor
Cabeçalho	dbgmodel.h

Confira também

Visão geral do modelo de dados do depurador C++