Interface IObjectWithBackReferences (shobjidl_core.h)

Article
03/06/2024

Fournit une méthode d’interaction avec les références arrière détenues par un objet .

Héritage

L’interface IObjectWithBackReferences hérite de l’interface IUnknown. IObjectWithBackReferences a également les types de membres suivants :

Méthodes

L’interface IObjectWithBackReferences utilise ces méthodes.


IObjectWithBackReferences ::RemoveBackReferences Supprime toutes les références antérieures détenues par un objet .

Remarques

Quand utiliser

Lorsqu’un objet contient des références en avant à des objets enfants qui ont des références antérieures à l’objet parent, des références circulaires peuvent se produire. Pour rompre ce cercle, l’objet parent doit effectuer le suivi des références back à partir d’objets enfants.

Quand implémenter

Cette interface doit être implémentée par des objets de source de données Shell (objets qui implémentent IShellFolder) qui contiennent des références à d’autres objets d’une manière qui peut entraîner des cycles de référence. Par exemple, un objet qui gère les références à d’autres objets de source de données mis en cache à la suite d’opérations de liaison doit implémenter cette interface.

Cette interface était disponible dans Windows Vista avec Service Pack 1 (SP1), mais elle n’a pas été déclarée dans un en-tête public avant Windows 7. Pour une utilisation dans Windows Vista avec SP1, le fragment IDL (Interface Definition Language) suivant décrit cette interface, y compris son IID.

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

Le fragment C++ suivant peut être utilisé pour activer l’accès à cette interface.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista avec SP1, Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (incluez Shobjidl.h)

Partager via