Интерфейс IModelKeyReference2 (dbgmodel.h)

2025-02-06

Ссылка на ключ объекта модели данных.

Эта версия 2 интерфейса поддерживает все предыдущие методы с идентичными сигнатурами и включает дополнительные новые методы, обеспечивающие добавленную функциональность. Новые методы перечислены в заголовке в конце раздела для этого интерфейса.

Наследство

IModelKeyReference2 наследует от IModelKeyReference.

Методика

Интерфейс IModelKeyReference2 имеет эти методы.


IModelKeyReference2::AddRef Метод IModelKeyReference2::AddRef увеличивает число ссылок для интерфейса в объекте.
IModelKeyReference2::GetContextObject Метод IModelKeyReference2::GetContextObject при вызове ссылки на ключ для объекта получает контекст объекта.
IModelKeyReference2::GetKey Метод IModelKeyReference2::GetKey при вызове ссылки на ключ получает значение базового ключа и все метаданные, связанные с ключом.
IModelKeyReference2::GetKeyName Метод IModelKeyReference2::GetKeyName при вызове ссылки на ключ получает имя базового ключа.
IModelKeyReference2::GetKeyValue Метод IModelKeyReference2::GetKeyValue при вызове ссылки на ключ получает значение базового ключа и все связанные с ним метаданные.
IModelKeyReference2::GetOriginalObject Метод IModelKeyReference2::GetOriginalObject при вызове ссылки на ключ получает объект экземпляра, из которого была создана ссылка на ключ.
IModelKeyReference2::OverrideContextObject Метод OverrideContextObject — это метод, который используется для окончательного изменения объекта контекста, который будет передаваться любому базовому методу доступа к свойствам GetValue или SetValue.
IModelKeyReference2::QueryInterface Метод IModelKeyReference2::QueryInterface извлекает указатели на поддерживаемые интерфейсы объекта.
IModelKeyReference2::Release Метод IModelKeyReference2::Release уменьшает количество ссылок для интерфейса объекта.
IModelKeyReference2::SetKey Метод IModelKeyReference2::SetKey при вызове ссылки на ключ перезаписывает объект, который является значением базового ключа.
IModelKeyReference2::SetKeyValue Метод IModelKeyReference2::SetKeyValue при вызове ссылки на ключ задает значение объекта, который является значением базового ключа.

Замечания

ссылки на ключи

По сути, ключевой ссылкой является дескриптор ключа для определенного объекта. Клиент может получить такой дескриптор с помощью таких методов, как GetKeyReference, и использовать дескриптор позже, чтобы получить или задать значение ключа без обязательного удержания исходного объекта. Этот тип объекта представляет собой реализацию интерфейса IModelKeyReference или интерфейса IModelKeyReference2, который упаковается в IModelObject. Объект модели возвращает тип ObjectKeyReference при запросе, а затем встроенное значение является VT_UNKNOWN, который гарантированно будет запрашиваться для IModelKeyReference. В процессе гарантируется статическая приведение к IModelKeyReference.

Требования

Требование	Ценность
заголовка	dbgmodel.h

См. также

Обзор модели данных отладчика C++