Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IObjectWithSite::SetSite Method

Provides the site's IUnknown pointer to the object.

Syntax


HRESULT SetSite(
    IUnknown *pUnkSite
);

Parameters

pUnkSite
[in] An interface pointer to the site managing this object. If NULL, the object should call IUnknown::Release to release the existing site.

Return Value

Returns S_OK in all circumstances.

Remarks

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.

Community Additions

Show:
© 2014 Microsoft. All rights reserved.