IObjectWithSiteImpl Class


The new home for Visual Studio documentation is Visual Studio 2017 Documentation on

The latest version of this topic can be found at IObjectWithSiteImpl Class.

This class provides methods allowing an object to communicate with its site.

template <class T>
    class ATL_NO_VTABLE IObjectWithSiteImpl :
    public IObjectWithSite


Your class, derived from IObjectWithSiteImpl.

Public Methods

IObjectWithSiteImpl::GetSiteQueries the site for an interface pointer.
IObjectWithSiteImpl::SetChildSiteProvides the object with the site's IUnknown pointer.
IObjectWithSiteImpl::SetSiteProvides the object with the site's IUnknown pointer.

Public Data Members

IObjectWithSiteImpl::m_spUnkSiteManages the site's IUnknown pointer.

The IObjectWithSite interface allows an object to communicate with its site. Class IObjectWithSiteImpl provides a default implementation of this interface and implements IUnknown by sending information to the dump device in debug builds.

IObjectWithSiteImpl specifies two methods. The client first calls SetSite, passing the site's IUnknown pointer. This pointer is stored within the object, and can later be retrieved through a call to GetSite.

Typically, you derive your class from IObjectWithSiteImpl when you are creating an object that is not a control. For controls, derive your class from IOleObjectImpl, which also provides a site pointer. Do not derive your class from both IObjectWithSiteImpl and IOleObjectImpl.



Header: atlcom.h

Queries the site for a pointer to the interface identified by riid.

    REFIID riid,
    void** ppvSite);


If the site supports this interface, the pointer is returned via ppvSite. Otherwise, ppvSite is set to NULL.

See IObjectWithSite::GetSite in the Windows SDK.

Manages the site's IUnknown pointer.

CComPtr<IUnknown> m_spUnkSite;


m_spUnkSite initially receives this pointer through a call to SetSite.

Provides the object with the site's IUnknown pointer.

HRESULT SetChildSite(IUnknown* pUnkSite);


[in] Pointer to the IUnknown interface pointer of the site managing this object. If NULL, the object should call IUnknown::Release on any existing site at which point the object no longer knows its site.

Return Value

Returns S_OK.

Provides the object with the site's IUnknown pointer.

STDMETHOD(SetSite)(IUnknown* pUnkSite);


See IObjectWithSite::SetSite in the Windows SDK.

Class Overview