CreateOleAdviseHolder

Creates an advise holder for managing compound document notifications. It returns an instance of the OLE implementation of the IOleAdviseHolder interface.

HRESULT CreateOleAdviseHolder(

ppOAHolder	//Pointer to a pointer
);

Parameter
ppOAHolder
Points to where to return the new IOleAdviseHolder instance.

Return Values
S_OK

Indicates that the new OLE advise holder returned successfully.

E_OUTOFMEMORY

Indicates insufficient memory to create new advise holder.

Comments
The helper function CreateOleAdviseHolder is an OLE implementation of the IOleAdviseHolder interface. Anyone who wants to write their own implementation of this interface may do so; but the advise holder returned by CreateOleAdviseHolder will suffice for the great majority of applications. If your application has a need to implement IOleAdviseHolder::EnumAdvise; you will need to implement your own advise holder because the one provided by OLE does not support this method.