Интерфейс IModelKeyReference2 (dbgmodel.h)
Ссылка на ключ в объекте модели данных.
Эта версия 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 |