Compartir a través de

Interfaz IObjectWithBackReferences (shobjidl_core.h)

  • Artículo

Proporciona un método para interactuar con las referencias inversas mantenidas por un objeto .

Herencia

La interfaz IObjectWithBackReferences hereda de la interfaz IUnknown . IObjectWithBackReferences también tiene estos tipos de miembros:

Métodos

La interfaz IObjectWithBackReferences tiene estos métodos.

 
IObjectWithBackReferences::RemoveBackReferences

Quita todas las referencias inversas que mantiene un objeto .

Comentarios

Cuándo usar

Cuando un objeto contiene referencias reenviadas a objetos secundarios que tienen referencias inversas al objeto primario, se pueden producir referencias circulares. Para romper este círculo, el objeto primario debe realizar un seguimiento de las referencias inversas de los objetos secundarios.

Cuándo implementar

Los objetos de origen de datos de Shell (objetos que implementan IShellFolder) que contienen referencias a otros objetos de forma que puedan dar lugar a ciclos de referencia. Por ejemplo, un objeto que mantiene referencias a otros objetos de origen de datos que se almacenan en caché como resultado de las operaciones de enlace debe implementar esta interfaz.

Esta interfaz estaba disponible en Windows Vista con Service Pack 1 (SP1), pero no se declaró en un encabezado público hasta Windows 7. Para su uso en Windows Vista con SP1, el siguiente fragmento del lenguaje de definición de interfaz (IDL) describe esta interfaz, incluido su IID.

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

El siguiente fragmento de C++ se puede usar para habilitar el acceso a esta interfaz.

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

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista con SP1, Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)