IOleAdviseHolder::SendOnSave
A version of this page is also available for
4/8/2010
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
| Header | Oleidl.h, oleidl.idl |
| Library | oleaut32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |
See Also
Reference
IOleAdviseHolder
CreateOleAdviseHolder
IAdviseSink::OnSave
IOleClientSite::SaveObject
IOleObject::Close