IExternalConnection::ReleaseConnection

Decrements an object's count of its strong external connections (references).

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: [in] 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: [in] 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: [in] 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.

Remarks

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.

QuickInfo

  Windows NT: Use version 3.1 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.