Interfaccia IObjectWithBackReferences (shobjidl_core.h)

Articolo
03/05/2024

Fornisce un metodo per interagire con i riferimenti indietro mantenuti da un oggetto.

Ereditarietà

L'interfaccia IObjectWithBackReferences eredita dall'interfaccia IUnknown . IObjectWithBackReferences include anche questi tipi di membri:

Metodi

L'interfaccia IObjectWithBackReferences include questi metodi.


IObjectWithBackReferences::RemoveBackReferences Rimuove tutti i riferimenti indietro mantenuti da un oggetto.

Commenti

Quando usare

Quando un oggetto contiene riferimenti inoltrati agli oggetti figlio che hanno riferimenti indietro all'oggetto padre, possono verificarsi riferimenti circolari. Per interrompere questo cerchio, l'oggetto padre deve tenere traccia dei riferimenti indietro dagli oggetti figlio.

Quando implementare

Questa interfaccia deve essere implementata dagli oggetti origine dati shell (oggetti che implementano IShellFolder) che contengono riferimenti ad altri oggetti in modo da generare cicli di riferimento. Ad esempio, un oggetto che gestisce riferimenti ad altri oggetti origine dati memorizzati nella cache come risultato delle operazioni di associazione deve implementare questa interfaccia.

Questa interfaccia è disponibile in Windows Vista con Service Pack 1 (SP1), ma non è stata dichiarata in un'intestazione pubblica fino a Windows 7. Per l'uso in Windows Vista con SP1, il frammento IDL (Interface Definition Language) seguente descrive questa interfaccia, incluso il relativo IID.

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

Il frammento C++ seguente può essere usato per abilitare l'accesso a questa interfaccia.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista con SP1, Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shobjidl_core.h (include Shobjidl.h)

Condividi tramite