IAdviseSinkEx

The IAdviseSinkEx interface is derived from IAdviseSink to provide extensions for notifying the sink of changes in an object's view status.

When to Implement

Container applications and compound documents implement a site object with the IAdviseSinkEx interface to receive notification of changes in the view status of a contained object.

When to Use

A contained object, such as a control, calls the method of IAdviseSinkEx to notify its container of changes in its view status.

To determine which interface the sink supports, an object must call QueryInterface using the pointer that was passed to IViewObject::SetAdvise.

Methods in Vtable Order

IUnknown Methods Description
QueryInterface Returns pointers to supported interfaces.
AddRef Increments reference count.
Release Decrements reference count.

IAdviseSink Methods Description
OnDataChange Advises that data has changed.
OnViewChange Advises that view of object has changed.
OnRename Advises that name of object has changed.
OnSave Advises that object has been saved to disk.
OnClose Advises that object has been closed.

IAdviseSinkEx Methods Description
OnViewStatusChange Notifies the sink that a view status of an object has changed.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in ocidl.h.

See Also

IAdviseSink, IViewObject::SetAdvise