Clase IObjectWithSiteImpl

Esta clase proporciona métodos que permiten a un objeto comunicarse con su sitio.

Sintaxis

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite

Parámetros

T
La clase, que se deriva de IObjectWithSiteImpl.

Miembros

Métodos públicos

Miembros de datos públicos

Comentarios

La interfaz IObjectWithSite permite que un objeto se comunique con su sitio. La clase IObjectWithSiteImpl proporciona una implementación predeterminada de esta interfaz e implementa IUnknown mediante el envío de información al dispositivo de volcado de memoria en las compilaciones de depuración.

IObjectWithSiteImpl especifica dos métodos. El cliente llama primero a SetSite y le pasa el puntero del sitio IUnknown. Este puntero se almacena dentro del objeto y posteriormente se puede recuperar si se llama a GetSite.

Normalmente, se deriva la clase de IObjectWithSiteImpl cuando crea un objeto que no es un control. Para los controles, derive la clase de IOleObjectImpl, que también proporciona un puntero de sitio. No derive la clase de tanto IObjectWithSiteImpl como IOleObjectImpl.

Jerarquía de herencia

IObjectWithSite

IObjectWithSiteImpl

Requisitos

Encabezado: atlcom.h

IObjectWithSiteImpl::GetSite

Consulta el sitio para un puntero a la interfaz identificado por riid.

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

Comentarios

Si el sitio admite esta interfaz, el puntero se devuelve a través de ppvSite. En caso contratio, se establece como NULL a ppvSite.

Consulte IObjectWithSite::GetSite en Windows SDK.

IObjectWithSiteImpl::m_spUnkSite

Administra el puntero del sitio IUnknown.

CComPtr<IUnknown> m_spUnkSite;

Comentarios

m_spUnkSite recibe inicialmente este puntero a través de una llamada a SetSite.

IObjectWithSiteImpl::SetChildSite

Proporciona el objeto con el puntero del sitio IUnknown.

HRESULT SetChildSite(IUnknown* pUnkSite);

Parámetros

pUnkSite
[in] Puntero al puntero de interfaz IUnknown del sitio que administra este objeto. Si es NULL, el objeto debe llamar a IUnknown::Release en cualquier sitio existente, en ese momento el objeto ya no conoce su sitio.

Valor devuelto

Devuelve S_OK.

IObjectWithSiteImpl::SetSite

Proporciona el objeto con el puntero del sitio IUnknown.

STDMETHOD(SetSite)(IUnknown* pUnkSite);

Comentarios

Consulte IObjectWithSite::SetSite en Windows SDK.

Consulte también

Información general sobre la clase