IDataAdviseHolder interface (objidl.h)
Creates and manages advisory connections between a data object and one or more advise sinks. Its methods are intended to be used to implement the advisory methods of IDataObject. IDataAdviseHolder is implemented on an advise holder object. Its methods establish and delete data advisory connections and send notification of change in data from a data object to an object that requires this notification, such as an OLE container, which must contain an advise sink.
Advise sinks are objects that require notification of change in the data the object contains and implement the IAdviseSink interface. Advise sinks are also usually associated with OLE compound document containers.
Inheritance
The IDataAdviseHolder interface inherits from the IUnknown interface. IDataAdviseHolder also has these types of members:
Methods
The IDataAdviseHolder interface has these methods.
| IDataAdviseHolder::Advise Creates a connection between an advise sink and a data object for receiving notifications. |
| IDataAdviseHolder::EnumAdvise Returns an object that can be used to enumerate the current advisory connections. |
| IDataAdviseHolder::SendOnDataChange Sends notifications to each advise sink for which there is a connection established by calling the IAdviseSink::OnDataChange method for each advise sink currently being handled by this instance of the advise holder object. |
| IDataAdviseHolder::Unadvise Removes a connection between a data object and an advisory sink that was set up through a previous call to IDataAdviseHolder::Advise. This method is typically called in the implementation of IDataObject::DUnadvise. |
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 | objidl.h |