|
IOleAdviseHolder
The IOleAdviseHolder 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
IUnknown Methods
| Description
| QueryInterface
| Returns pointers to supported interfaces.
| AddRef
| Increments reference count.
| Release
| Decrements reference count.
|
IOleAdviseHolder Methods
| Description
| Advise
| Establishes advisory connection with sink.
| Unadvise
| Deletes advisory connection with sink.
| EnumAdvise
| Lists current advisory connections.
| SendOnRename
| Advises that name of object has changed.
| SendOnSave
| Advises that object has been saved.
| SendOnClose
| Advises that object has been closed.
|
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
