CreateDataAdviseHolder

Returns a new instance of an OLE-provided implementation of the IDataAdviseHolder interface.

STDAPI CreateDataAdviseHolder(

IDataAdviseHolder **ppDAHolder	//Pointer to the new instance of IDataAdviseHolder
);

Parameter
ppDAHolder

Points to the location where the pointer to the new advise holder object should be returned.

Return Values
S_OK

The IDataAdviseHolder interface was instantiated and the pointer returned.

E_OUTOFMEMORY

Indicates that OLE ran out of memory and IDataAdviseHolder could not be instantiated.

Comments
The IDataAdviseHolder interface is called by your implementation of the IDataObject::DAdvise interface to keep track of connections to advise sinks and to send notifications when necessary.