Contents Index Topic Contents
	Previous Topic: IObjectWithSite::GetSite Next Topic: IPersistMemory

IObjectWithSite::SetSite

HRESULT SetSite(
    IUnknown *pUnkSite);

Provides the site's IUnknown pointer to the object. The object should hold onto this 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, then save pUnkSite.

• Returns:

  S_OK	Returned in all circumstances

pUnkSite

[in] 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.

E_NOTIMPL is disallowed—without implementation of SetSite, the IObjectWithSite interface is unnecessary.

---

 Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.