IExternalConnection::ReleaseConnection-Methode (objidl.h)
Verringert die Anzahl der starken externen Verbindungen eines Objekts.
Syntax
DWORD ReleaseConnection(
[in] DWORD extconn,
[in] DWORD reserved,
[in] BOOL fLastReleaseCloses
);
Parameter
[in] extconn
Der Typ der externen Verbindung mit dem -Objekt. Der einzige externe Verbindungstyp, der derzeit von dieser Schnittstelle unterstützt wird, ist stark, was bedeutet, dass das Objekt am Leben bleiben muss, solange diese externe Verbindung vorhanden ist. Starke externe Verbindungen werden durch den Wert EXTCONN_STRONG dargestellt, der in der Enumeration EXTCONN definiert ist.
[in] reserved
Informationen zur Verbindung. Dieser Parameter ist für die Verwendung durch OLE reserviert. Sein Wert kann null sein, aber nicht unbedingt. Daher sollten Implementierungen von ReleaseConnection keine Codeblöcke enthalten, deren Ausführung davon abhängt, ob ein Nullwert zurückgegeben wird.
[in] fLastReleaseCloses
Dieser Parameter ist TRUE , wenn die freigegebene Verbindung die letzte externe Sperre für das Objekt ist und daher das Objekt geschlossen werden sollte. Andernfalls sollte das Objekt geöffnet bleiben, bis es vom Benutzer oder einem anderen Prozess geschlossen wird.
Rückgabewert
Die -Methode gibt die Anzahl der Verbindungen zurück. Dieser Wert ist nur für Debuggingzwecke vorgesehen.
Hinweise
Wenn fLastReleaseClosesgleich TRUE ist, führt das Aufrufen von ReleaseConnection dazu, dass sich das Objekt selbst herunterfährt. Das Aufrufen dieser Methode ist die einzige Möglichkeit, mit der ein DLL-Objekt, das im selben Prozessbereich wie die Containeranwendung ausgeführt wird, nach einem automatischen Update geschlossen werden soll.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h (include ObjIdl.h) |