|
IOleObject::Update
Updates an object handler's or link object's data or view caches.
HRESULT Update();
Return Values
S_OK
All caches are up to date.
E_FAIL
An unspecified error occurred.
OLE_E_CANT_BINDTOSOURCE
Cannot run object to get updated data. The object is for some reason
unavailable to the caller.
CACHE_E_NOCACHE_UPDATED
No caches were updated.
CACHE_S_SOMECACHES_NOTUPDATED
Some caches were not updated.
Comments
The Update method provides a way for containers to keep data updated in their linked and
embedded objects. A link object can become out-of-date if the link source has
been updated. An embedded object that contains links to other objects can also
become out of date. An embedded object that does not contain links cannot become
out of date because its data is not linked to another source.
Notes to Implementors
When a container calls a link object's IOleObject::Update method, the link object finds the link source and gets a new presentation from
it. This process may also involve running one or more object applications,
which could be time-consuming.
When a container calls an embedded object's IOleObject::Update method, it is requesting the object to update all link objects it may contain.
In response, the object handler recursively calls IOleObject::Update for each of its own linked objects, running each one as needed.
See Also
IOleObject::IsUpToDate
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
