Interface IObjectWithBackReferences (shobjidl_core.h)

  • Artigo

Fornece um método para interagir com referências back mantidas por um objeto .

Herança

A interface IObjectWithBackReferences herda da interface IUnknown . IObjectWithBackReferences também tem estes tipos de membros:

Métodos

A interface IObjectWithBackReferences tem esses métodos.

 
IObjectWithBackReferences::RemoveBackReferences

Remove todas as referências de fundo mantidas por um objeto .

Comentários

Quando usar

Quando um objeto contém referências de encaminhamento para objetos filho que têm referências de volta ao objeto pai, podem ocorrer referências circulares. Para quebrar esse círculo, o objeto pai precisa acompanhar as referências de back de objetos filho.

Quando implementar

Essa interface deve ser implementada por objetos de fonte de dados do Shell (objetos que implementam IShellFolder) que contêm referências a outros objetos de uma maneira que possa resultar em ciclos de referência. Por exemplo, um objeto que mantém referências a outros objetos de fonte de dados armazenados em cache como resultado de operações de associação deve implementar essa interface.

Essa interface estava disponível no Windows Vista com Service Pack 1 (SP1), mas não foi declarada em um cabeçalho público até o Windows 7. Para uso no Windows Vista com SP1, o fragmento de IDL (Interface Definition Language) a seguir descreve essa interface, incluindo seu IID.

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

O fragmento C++ a seguir pode ser usado para habilitar o acesso a essa interface.

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

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista com SP1, Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shobjidl_core.h (inclua Shobjidl.h)