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 |