Classe IObjectWithSiteImpl

Essa classe fornece métodos que permitem que um objeto se comunique com seu site.

Sintaxe

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Parâmetros

T
Sua classe, derivada de IObjectWithSiteImpl.

Membros

Métodos públicos

Membros de Dados Públicos

Comentários

A interface IObjectWithSite permite que um objeto se comunique com seu site. A classe IObjectWithSiteImpl fornece uma implementação padrão dessas interfaces e implementa IUnknown enviando informações para o dispositivo de despejo em builds de depuração.

IObjectWithSiteImpl especifica dois métodos. O cliente primeiro chama SetSite, passando o ponteiro IUnknown do site. Esse ponteiro é armazenado no objeto e, posteriormente, poderá ser recuperado por meio de uma chamada para GetSite.

Normalmente, você deriva sua classe de IObjectWithSiteImpl quando você está criando um objeto que não é um controle. Para controles, derive sua classe de IOleObjectImpl, que também fornece um ponteiro do site. Não derive sua classe de IObjectWithSiteImpl e IOleObjectImpl.

Hierarquia de herança

IObjectWithSite

IObjectWithSiteImpl

Requisitos

Cabeçalho: atlcom.h

IObjectWithSiteImpl::GetSite

Consulta o site para obter um ponteiro para a interface identificada por riid.

STDMETHOD(GetSite)(
    REFIID riid,
    void** ppvSite);

Comentários

Se o site der suporte a essa interface, o ponteiro será retornado por meio de ppvSite. Caso contrário, ppvSite será definido como NULL.

Confira IObjectWithSite::GetSite no SDK do Windows.

IObjectWithSiteImpl::m_spUnkSite

Gerencia o ponteiro IUnknown do site.

CComPtr<IUnknown> m_spUnkSite;

Comentários

m_spUnkSite inicialmente recebe esse ponteiro por meio de uma chamada para SetSite.

IObjectWithSiteImpl::SetChildSite

Fornece o objeto com o ponteiro IUnknown do site.

HRESULT SetChildSite(IUnknown* pUnkSite);

Parâmetros

pUnkSite
[in] Ponteiro para o ponteiro de interface IUnknown do site que gerencia esse objeto. Se NULL, o objeto deverá chamar IUnknown::Release em qualquer site existente, momento em que o objeto não conhece mais seu site.

Valor de retorno

Returns S_OK.

IObjectWithSiteImpl::SetSite

Fornece o objeto com o ponteiro IUnknown do site.

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Comentários

Confira IObjectWithSite::SetSite no SDK do Windows.

Confira também

Visão geral da aula