Edit

IDataAdviseHolder interface (objidl.h)

  • Article

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

See also

IAdviseSink

IDataObject