Partilhar via

IObjectWithSiteImpl Class

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Esta classe fornece métodos que permitem a um objeto comunicar com o seu site.

Sintaxe

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Parâmetros

T
A sua classe, derivada de IObjectWithSiteImpl.

Membros

Métodos Públicos

Nome Description
IObjectWithSiteImpl::GetSite Consulta o site à procura de um ponteiro de interface.
IObjectWithSiteImpl::SetChildSite Fornece ao objeto o ponteiro do IUnknown site.
IObjectWithSiteImpl::SetSite Fornece ao objeto o ponteiro do IUnknown site.

Membros de Dados Públicos

Nome Description
IObjectWithSiteImpl::m_spUnkSite Gerir o ponteiro do IUnknown site.

Observações

A interface IObjectWithSite permite que um objeto comunique com o seu site. A Class IObjectWithSiteImpl fornece uma implementação padrão desta interface e é IUnknown implementada enviando informação para o dispositivo de despejo em compilações de depuração.

IObjectWithSiteImpl especifica dois métodos. O cliente liga SetSiteprimeiro, passando o ponteiro do IUnknown site. Este ponteiro é armazenado dentro do objeto e pode ser posteriormente recuperado através de uma chamada para GetSite.

Normalmente, derivas a tua classe quando IObjectWithSiteImpl estás a criar um objeto que não é um controlo. Para controlos, derive a sua classe a partir do IOleObjectImpl, que também fornece um ponteiro de site. Não derive a sua classe a partir de ambosIObjectWithSiteImpl.IOleObjectImpl

Hierarquia de herança

IObjectWithSite

IObjectWithSiteImpl

Requerimentos

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);

Observações

Se o site suportar esta interface, o ponteiro é devolvido via ppvSite. Caso contrário, ppvSite está definido como NULL.

Veja IObjectWithSite::GetSite no SDK do Windows.

IObjectWithSiteImpl::m_spUnkSite

Gerir o ponteiro do IUnknown site.

CComPtr<IUnknown> m_spUnkSite;

Observações

m_spUnkSite inicialmente recebe este ponteiro através de uma chamada para o SetSite.

IObjectWithSiteImpl::SetChildSite

Fornece ao objeto o ponteiro do IUnknown site.

HRESULT SetChildSite(IUnknown* pUnkSite);

Parâmetros

pUnkSite
[dentro] Apontador para o IUnknown ponteiro de interface do site que gere este objeto. Se for NULL, o objeto deve chamar IUnknown::Release qualquer site existente, momento em que o objeto já não conhece o seu site.

Valor de retorno

Devolve S_OK.

IObjectWithSiteImpl::SetSite

Fornece ao objeto o ponteiro do IUnknown site.

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Observações

Veja IObjectWithSite::SetSite no SDK do Windows.

Consulte também

Visão geral da classe

  • Last updated on