interface enables object applications to delegate the management of compound
document registration requests and notifications to a special object called the
OLE advise holder. The OLE advise holder implements the IOleAdviseHolder
interface, which provides methods for establishing and deleting advisory
connections and for sending compound document notifications to advise sinks.
When an object application uses the OLE advise holder, it passes notifications
directly to the IOleAdviseHolder
interface. The advise holder keeps track of which advise sinks are interested
in which notifications and passes along the notifications as appropriate.
When to Implement
OLE provides a default implementation of the OLE advise holder as a
convenience to programmers. Use of the default implementation is optional because object
applications can be written to manage notifications themselves. By using the
default code, however, you save yourself the work of re-creating the advise
holder's functionality from scratch as part of your implementation of IOleObject::Advise
. Few applications will require notification capabilities beyond those which
the default advise holder provides.
Applications instantiate an OLE advise holder by calling the OLE API function CreateOleAdviseHolder
. (OLE also provides a data advise holder to manage data notifications.
Applications create a data advise holder by calling the OLE API function CreateDataAdviseHolder
When to Use
Containers and other objects that wish to receive compound document
notifications must implement the IAdviseSink
interface to receive those notifications, and call the IOleAdviseHolder
interface to establish an advisory connection and inform the object of what
specific notifications it wishes to receive.
Methods in VTable Order
||Returns pointers to supported interfaces.
||Increments reference count.
||Decrements reference count.
||Establishes advisory connection with sink.
||Deletes advisory connection with sink.
||Lists current advisory connections.
||Advises that name of object has changed.
||Advises that object has been saved.
||Advises that object has been closed.
- Software for developers
Software for Android Developers
- More information resources
Unix Manual Pages