Compartilhar via


Interface IModelKeyReference2 (dbgmodel.h)

Uma referência a uma chave em um objeto de modelo de dados.

Esta versão 2 da interface dá suporte a todos os métodos anteriores com assinaturas idênticas e inclui novos métodos adicionais que fornecem funcionalidade adicional. Os novos métodos são listados no cabeçalho no final da seção para essa interface.

Herança

IModelKeyReference2 herda de IModelKeyReference.

Métodos

A interface IModelKeyReference2 tem esses métodos.

 
IModelKeyReference2::AddRef

O método IModelKeyReference2::AddRef incrementa a contagem de referência para uma interface em um objeto .
IModelKeyReference2::GetContextObject

O método IModelKeyReference2::GetContextObject, quando chamado em uma referência de chave para um objeto, obtém o contexto do objeto.
IModelKeyReference2::GetKey

O método IModelKeyReference2::GetKey, quando chamado em uma referência de chave, obtém o valor da chave subjacente e todos os metadados associados à chave.
IModelKeyReference2::GetKeyName

O método IModelKeyReference2::GetKeyName, quando chamado em uma referência de chave, obtém o nome da chave subjacente.
IModelKeyReference2::GetKeyValue

O método IModelKeyReference2::GetKeyValue, quando chamado em uma referência de chave, obtém o valor da chave subjacente e todos os metadados associados a ela.
IModelKeyReference2::GetOriginalObject

O método IModelKeyReference2::GetOriginalObject, quando chamado em uma referência de chave, obtém o objeto de instância do qual a referência de chave foi criada.
IModelKeyReference2::OverrideContextObject

O método OverrideContextObject é um método usado para alterar permanentemente o objeto de contexto que essa referência de chave passará para os métodos GetValue ou SetValue de qualquer acessador de propriedade subjacente.
IModelKeyReference2::QueryInterface

O método IModelKeyReference2::QueryInterface recupera ponteiros para as interfaces com suporte em um objeto .
IModelKeyReference2::Release

O método IModelKeyReference2::Release diminui a contagem de referência para uma interface em um objeto .
IModelKeyReference2::SetKey

O método IModelKeyReference2::SetKey, quando chamado em uma referência de chave, substitui o objeto que é o valor da chave subjacente.
IModelKeyReference2::SetKeyValue

O método IModelKeyReference2::SetKeyValue, quando chamado em uma referência de chave, define o valor do objeto que é o valor da chave subjacente.

Comentários

Referências de chave

Uma referência de chave é, em essência, um identificador para uma chave em um objeto específico. Um cliente pode recuperar esse identificador por meio de métodos como GetKeyReference e usar o identificador posteriormente para obter ou definir o valor da chave sem necessariamente manter o objeto original. Esse tipo de objeto é uma implementação da interface IModelKeyReference ou IModelKeyReference2 que é encaixada em um IModelObject. O objeto modelo retornará um tipo de ObjectKeyReference quando consultado e, em seguida, o valor intrínseco é um VT_UNKNOWN que é garantido ser consultável para IModelKeyReference. Em processo, é garantido que ele seja castível estaticamente para IModelKeyReference.

Requisitos

Requisito Valor
Cabeçalho dbgmodel.h

Confira também

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