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
| Nome | Descrição |
|---|---|
| IObjectWithSiteImpl::GetSite | Consulta o site por um ponteiro de interface. |
| IObjectWithSiteImpl::SetChildSite | Fornece o objeto com o ponteiro IUnknown do site. |
| IObjectWithSiteImpl::SetSite | Fornece o objeto com o ponteiro IUnknown do site. |
Membros de Dados Públicos
| Nome | Descrição |
|---|---|
| IObjectWithSiteImpl::m_spUnkSite | Gerencia o ponteiro IUnknown do site. |
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.