IOleAdviseHolder::SendOnSave

This method sends IAdviseSink::OnSave notifications to all advisory sinks currently registered with the advise holder.

At a Glance

Syntax

HRESULT SendOnSave()

Return Values

S_OK indicates that advise sinks were sent IAdviseSink::OnSave notifications.

Remarks

IOleAdviseHolder::SendOnSave calls IAdviseSink::OnSave to advise the calling object (client), which must have already established an advisory connection, that the object has been saved. If you are using the OLE advise holder (having obtained a pointer through a call to CreateOleAdviseHolder), you can call IOleAdviseHolder::SendOnSave whenever you save the object the advise holder is associated with.

To take the object from the running state to the loaded state, the client calls IOleObject::Close. Within that implementation, if the user wants to save the object to persistent storage, the object calls IOleClientSite::SaveObject, followed by the call to IOleAdviseHolder::SendOnSave.