Provides the site's IUnknown pointer to the object.
HRESULT SetSite( IUnknown *pUnkSite );
- [in] An interface pointer to the site managing this object. If NULL, the object should call IUnknown::Release to release the existing site.
Returns S_OK in all circumstances.
The object should hold the IUnknown pointer, calling AddRef in doing so. If the object already has a site, it should first call pUnkSite->AddRef to secure the new site, call IUnknown::Release on the existing site, and then save pUnkSite.
E_NOTIMPL is disallowed. If the IObjectWithSite::SetSite method is not implemented, the IObjectWithSite interface is unnecessary.