Share via

IOleAdviseHolder::SendOnSave

  • Article

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

HRESULT SendOnSave()

Parameters

None.

Return Values

S_OK indicates that advise sinks were sent OnSave notifications.

Remarks

SendOnSave calls 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 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

OS Versions: Windows CE 2.0 and later.
Header: Oleidl.h, Oleidl.idl.
Link Library: Oleaut32.lib, Uuid.lib.

See Also

IOleAdviseHolder | CreateOleAdviseHolder | Determining Supported COM APIs | IAdviseSink::OnSave | IOleClientSite::SaveObject | IOleObject::Close

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.