IObjectWithSite

  • Article

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.

Requirements

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: Declared in ocidl.h

Last updated on Friday, April 22, 2005

© 2005 Microsoft Corporation. All rights reserved.

Send feedback on this topic to the authors.