CreateOleAdviseHolder
Creates an
advise holder object for managing compound document notifications. It returns a
pointer to the object s OLE implementation of the IOleAdviseHolder
interface.
WINOLEAPI CreateOleAdviseHolder(
|
ppOAHolder |
//Indirect pointer to the advise holder object |
|
); |
|
Parameter
ppOAHolder
[out]
Indirect pointer to the IOleAdviseHolder interface on the new advise
holder object.
Return Values
This function
supports the standard return value E_OUTOFMEMORY, as well as the following:
S_OK
The new OLE
advise holder returned successfully.
Remarks
The function CreateOleAdviseHolder
creates an instance of an advise holder, which supports the OLE implementation
of the IOleAdviseHolder interface. The methods of this interface are
intended to be used to implement the advisory methods of IOleObject,
and, when advisory connections have been set up with objects supporting an
advisory sink, to send notifications of changes in the object to the advisory
sink. The advise holder returned by CreateOleAdviseHolder will suffice
for the great majority of applications. The OLE-provided implementation does
not, however, support IOleAdviseHolder::EnumAdvise, so if you need to
use this method, you will need to implement your own advise holder.
See Also
IOleAdviseHolder, IOleObject