IOleAdviseHolder::SendOnSave (Compact 2013)

3/26/2014

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

Syntax

HRESULT SendOnSave() 

Parameters

None.

Return Value

S_OK indicates that advise sinks were sent OnSave notifications.

Remarks

SendOnSave calls OnSave to advise the calling object (client), which must have 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 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 SendOnSave.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

See Also

Tasks

Determine Supported COM APIs

Reference

IOleAdviseHolder
CreateOleAdviseHolder
IAdviseSink::OnSave
IOleClientSite::SaveObject
IOleObject::Close