IObjectWithSite

Windows Mobile 6.5
4/8/2010

The IObjectWithSite interface provides simple objects with a light-weight "siting" mechanism. This allows simple objects to communicate directly with their container site objects, allowing them to manage the site object by themselves.

Bb416363.note(en-us,MSDN.10).gifNote:
If you use IObjectWithSite, do not use the Windows Embedded CE IOleObject interface.

A container can pass the IUnknown pointer of its site to an object through IObjectWithSite::SetSite. Callers can also retrieve the latest site passed to IObjectWithSite::SetSite through IObjectWithSite::GetSite. This usage provides a hooking mechanism, allowing third parties to intercept calls from an object to its container site object.

Implement this interface when you want to give an object the ability to manage its container site object.

A container calls the IObjectWithSite::SetSite method to provide an object with an interface pointer to its site.

  • IUnknown methods

    IObjectWithSite methods Description

    SetSite

    Passes the container site object's IUnknown pointer to the object being managed.

    GetSite

    Retrieves the IUnknown pointer from the last site set with IObjectWithSite::SetSite.

Headerocidl.h
Windows Embedded CEWindows CE 3.0 and later
Windows MobilePocket PC 2000 and later, Smartphone 2002 and later
Show: