Interface IDebugHostContext (dbgmodel.h)

Representa um contexto do depurador que responde perguntas 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.

Observações

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. Pode incluir itens 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 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á examinando) é 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 tomam 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 retornados por ele. Isso significa que, quando você lê um valor nativo ou um valor de chave de um IModelObject, ele será lido fora do destino e do processo do qual o objeto foi originalmente adquirido. 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

Consulte também

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