IObjectWithSite interface (ocidl.h)

Provides a simple way to support communication between an object and its site in the container.

Often an object needs to communicate directly with a container site object and, in effect, manage the site object itself. Outside of IOleObject::SetClientSite, there is no generic means through which an object becomes aware of its site. IObjectWithSite provides simple objects with a simple siting mechanism (lighter than IOleObject) This interface should only be used when IOleObject is not already in use.

Through IObjectWithSite, a container can pass the IUnknown pointer of its site to the object through IObjectWithSite::SetSite. Callers can also retrieve the latest site passed to SetSite through IObjectWithSite::GetSite. This latter method is included as a hooking mechanism, allowing a third party to intercept calls from the object to the site.

Inheritance

The IObjectWithSite interface inherits from the IUnknown interface. IObjectWithSite also has these types of members:

Methods

The IObjectWithSite interface has these methods.

 
IObjectWithSite::GetSite

Retrieves the latest site passed using SetSite.
IObjectWithSite::SetSite

Enables a container to pass an object a pointer to the interface for its site.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header ocidl.h