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.
Note If you use IObjectWithSite, do not use the Windows 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.
When to Implement
Implement this interface when you want to give an object the ability to manage its container site object.
When to Use
A container calls the IObjectWithSite::SetSite method to provide an object with an interface pointer to its site.
Methods in Vtable Order
- 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.
Pocket PC: Pocket PC 2000 and later.
Smartphone: Smartphone 2002 and later.
OS Versions: Windows CE 3.0 and later.
Header: Declared in ocidl.h.
Send Feedback on this topic to the authors