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
| Nombre | Descripción |
|---|---|
| IObjectWithSiteImpl::GetSite | Consultas del sitio para un puntero de interfaz. |
| IObjectWithSiteImpl::SetChildSite | Proporciona el objeto con el puntero del sitio IUnknown. |
| IObjectWithSiteImpl::SetSite | Proporciona el objeto con el puntero del sitio IUnknown. |
Miembros de datos públicos
| Nombre | Descripción |
|---|---|
| IObjectWithSiteImpl::m_spUnkSite | Administra el puntero del sitio IUnknown. |
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.