IObjectWithSite::SetSite

4/8/2010

The SetSite method passes the container site object's IUnknown pointer to the object being managed. Once the managed object has received the pointer, it should use it to call the Windows Embedded CE IUnknown::AddRefmethod. If the object already has a site, it should save the new site's pointer, call the Windows Embedded CE IUnknown::Release method with the original site's IUnknown pointer, and then call IUnknown::AddRef with the new site's pointer.

Syntax

HRESULT SetSite (
  IUnknown * pUnkSite
);

Parameters

  • pUnkSite
    [in] Reference to the IUnknown interface pointer belonging to the site that is managing this object. If pUnkSite is NULL, call IUnknown::Release on any existing site for which the object is no longer set.

Return Value

  • S_OK
    Indicates success.

Requirements

Header ocidl.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later, Smartphone 2002 and later

See Also

Reference

IContextMenu
IObjectWithSite
IObjectWithSite::GetSite

Other Resources

IUnknown::AddRef
IUnknown::Release