|
IExternalConnection
The IExternalConnection interface enables an embedded object to keep track of external locks on it,
thereby enabling the safe and orderly shutdown of the object following silent
updates. An object that supports links either to itself or to some portion of
itself (a range of cells in a spreadsheet, for example) should implement this
interface to prevent possible loss of data during shutdown.
Such data loss can occur when an object happens to have unsaved changes at a
time when its stub manager's count of strong external references has reached
zero. This situation would arise, for example, at the end of a silent update, when
the final link client breaks its connection to the object. With the severing
of this connection, the stub manager's count of strong external references would
reach zero, causing it to release its pointers to the object and initiate
shutdown of the object. When the object calls IOleClientSite::SaveObject, its container's return call to IPersistStorage::Save would fail because the stub manager would no longer have a pointer to the
object. Any unsaved changes to the object would be lost.
If the object manages its own count of external locks, rather than relying on
the stub manager to do so, it can save its data before the stub manager has a
chance to release its pointers. An object can obtain a count of external
connections by implementing the IExternalConnection interface. The stub manager calls this interface whenever a new strong
external reference is added or deleted. The object combines this count with its own
tally of strong internal references to maintain an accurate total of all locks.
When to Implement
All embeddable compound-document objects that support links to themselves or
portions of themselves should implement IExternalConnection to prevent possible data loss during shutdown. In addition, an in-place
container should call OleLockRunning to hold a strong lock on its embedded objects.
When to Use
An object's stub manager should call IExternalConnection whenever an external connection is added or released.
Methods in VTable Order
| Last news from Greatis Software |
 |
|
Nostalgia .Net |
|
.Net is powerful, but not all-powerful, so sometimes we need to use Win32 API for our .Net applications. It's simple enough with Platform Invoke if you have Win32 skill, but we do not always have time to dig the ancient documentation, declare the special types that are compatible with Win32, find the values of the Win32's constants and so on. Nostalgia .Net offers several simple-to-use classes, and components that will allow you to forget about the headache of Win32 and just use the power of Win32 in your application the same way as you use the native. Net classes. More » |
| Recommended software for developers |
 |
|
Ultimate Pack |
|
Component pack for Delphi and C++ Builder that contains runtime form designer, runtime object inspector, print suite and much more for the very special price. More » |
 |
|
Form Designer .Net |
|
Unique runtime form design solution that allows to edit any form in .Net WinForms application at runtime with full source codes for only 300 euro! More » |
 |
|
Print Suite .Net |
|
Print Suite .Net is a set of components for easy printing texts, images and grids from your WinForms applications. Full C# source codes are available More » |
 |
|
Gradient Controls .Net |
|
Gradient Controls .Net offers controls with gradient background feature. Labels, panels and so on... Full C# source codes are available More » |
 |
|
Greatis iGrid |
|
iGrid plots drawing grid right over your desktop, so you can use it everywhere, with any drawing application without any special plugins for different graphic editors. More » |
All the contacts and projectsDmitry Vasiliev (just.dmitry)
Related LinksSoftware for Visual Studio .NET developers
Software for Delphi and C++ Builder developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET More Online Helps Win32 Programmer's Reference
Win32 Multimedia Programmer's Reference
OLE Programmer's Reference
Microsoft Windows Pen API Programmer's Reference
Microsoft Windows Sockets 2 Reference
Microsoft Windows Telephony API (TAPI) Programmer's Reference
Unix Manual Pages
|
