IObjectWithBackReferences-Schnittstelle (shobjidl_core.h)

Artikel
08/26/2023

Stellt eine Methode für die Interaktion mit Rückverweise bereit, die von einem Objekt gehalten werden.

Vererbung

Die IObjectWithBackReferences-Schnittstelle erbt von der IUnknown-Schnittstelle . IObjectWithBackReferences verfügt auch über die folgenden Typen von Membern:

Methoden

Die IObjectWithBackReferences-Schnittstelle verfügt über diese Methoden.


IObjectWithBackReferences::RemoveBackReferences Entfernt alle Rückverweise, die von einem Objekt gehalten werden.

Hinweise

Wann sollte verwendet werden?

Wenn ein Objekt Vorwärtsverweise auf untergeordnete Objekte enthält, die Rückverweise auf das übergeordnete Objekt aufweisen, können Zirkelverweise auftreten. Um diesen Kreis zu durchbrechen, muss das übergeordnete Objekt die Rückverweise von untergeordneten Objekten nachverfolgen.

Wann muss implementiert werden?

Diese Schnittstelle sollte von Shell-Datenquellenobjekten (Objekten, die IShellFolder implementieren) implementiert werden, die Verweise auf andere Objekte auf eine Weise enthalten, die zu Verweiszyklen führen kann. Beispielsweise sollte diese Schnittstelle von einem Objekt implementiert werden, das Verweise auf andere Datenquellenobjekte verwaltet, die als Ergebnis von Bindungsvorgängen zwischengespeichert werden.

Diese Schnittstelle war in Windows Vista mit Service Pack 1 (SP1) verfügbar, wurde aber erst unter Windows 7 in einem öffentlichen Header deklariert. Für die Verwendung in Windows Vista mit SP1 beschreibt das folgende IDL-Fragment (Interface Definition Language) diese Schnittstelle, einschließlich ihrer IID.

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

Das folgende C++-Fragment kann verwendet werden, um den Zugriff auf diese Schnittstelle zu ermöglichen.

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

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista mit SP1, Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Freigeben über