|
IExternalConnection::ReleaseConnection
Decrements an object's count of its strong external connections (links).
HRESULT ReleaseConnection(
DWORD extconn,
| //Type of external connection
| DWORD dwreserved,
| //Used by OLE to pass connection information
| BOOL fLastReleaseCloses
| //Indicates whether connection is last one or not
| );
|
|
Parameters
extconn
[out] Specifies the type of external connection to the object. The only type
of external connection currently supported by this interface is strong, which
means that the object must remain alive as long as this external connection
exists. Strong external connections are represented by the value EXTCONN_STRONG =
0x0001, which is defined in the enumeration EXTCONN.
dwreserved
Passes information about the connection. This parameter is reserved for use by
OLE. Its value can be zero, but not necessarily. Therefore, implementations of ReleaseConnection should not contain blocks of code whose execution depends on whether a zero
value is returned.
fLastReleaseCloses
TRUE specifies that if the connection being released is the last external lock
on the object, the object should close. FALSE specifies that the object should
remain open until closed by the user or another process.
Return Value
DWORD value
The number of connections to the object; used for debugging purposes only.
Comments
If fLastReleaseCloses equals TRUE, calling ReleaseConnection causes the object to shut itself down. Calling this method is the only way in
which a DLL object, running in the same process space as the container
application, will know when to close following a silent update.
See Also
IExternalConnection::AddConnection
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
|
