Прочитать на английском

Поделиться через

Интерфейс IObjectWithBackReferences (shobjidl_core.h)

  • Статья
  • 05.03.2024

Предоставляет метод для взаимодействия с обратными ссылками, удерживаемыми объектом .

Наследование

Интерфейс IObjectWithBackReferences наследуется от интерфейса IUnknown . IObjectWithBackReferences также имеет следующие типы членов:

Методы

Интерфейс IObjectWithBackReferences содержит следующие методы.

 
IObjectWithBackReferences::RemoveBackReferences

Удаляет все обратные ссылки, хранящиеся в объекте .

Комментарии

Когда следует использовать

Если объект содержит прямую ссылку на дочерние объекты, которые имеют обратные ссылки на родительский объект, могут возникать циклические ссылки. Чтобы разорвать этот круг, родительский объект должен отслеживать обратные ссылки из дочерних объектов.

Когда следует реализовать

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

Этот интерфейс был доступен в Windows Vista с пакетом обновления 1 (SP1), но он не был объявлен в общедоступном заголовке до Windows 7. Для использования в Windows Vista с пакетом обновления 1 (SP1) следующий фрагмент языка определения интерфейса (IDL) описывает этот интерфейс, включая его IID.

object,
    uuid(321a6a6a-d61f-4bf3-97ae-14be2986bb36),
    pointer_default(unique)
]
interface IObjectWithBackReferences : IUnknown
{
    HRESULT RemoveBackReferences();
}

Следующий фрагмент C++ можно использовать для предоставления доступа к этому интерфейсу.

struct 
    __declspec(uuid("321a6a6a-d61f-4bf3-97ae-14be2986bb36")) 
    __declspec(novtable)
IObjectWithBackReferences : public IUnknown
{
    public:
        virtual HRESULT __stdcall RemoveBackReferences() = 0;
};

Требования

Требование Значение
Минимальная версия клиента Windows Vista с пакетом обновления 1 (SP1), Windows 7 [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2 [только классические приложения]
Целевая платформа Windows
Header shobjidl_core.h (включая Shobjidl.h)