Interface IObjectWithSite (ocidl.h)

  • Artigo

Fornece uma maneira simples de dar suporte à comunicação entre um objeto e seu site no contêiner.

Geralmente, um objeto precisa se comunicar diretamente com um objeto de site de contêiner e, na verdade, gerenciar o próprio objeto do site. Fora de IOleObject::SetClientSite, não há nenhum meio genérico por meio do qual um objeto fique ciente de seu site. IObjectWithSite fornece objetos simples com um mecanismo de siting simples (mais leve que IOleObject) Essa interface só deve ser usada quando IOleObject ainda não estiver em uso.

Por meio de IObjectWithSite, um contêiner pode passar o ponteiro IUnknown de seu site para o objeto por meio de IObjectWithSite::SetSite. Os chamadores também podem recuperar o site mais recente passado para SetSite por meio de IObjectWithSite::GetSite. Este último método é incluído como um mecanismo de gancho, permitindo que um terceiro intercepte chamadas do objeto para o site.

Herança

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

Métodos

A interface IObjectWithSite tem esses métodos.

 
IObjectWithSite::GetSite

Recupera o site mais recente passado usando SetSite.
IObjectWithSite::SetSite

Permite que um contêiner passe um objeto um ponteiro para a interface de seu site.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho ocidl.h