IExternalConnection::ReleaseConnection-Methode (objidlbase.h)

  • Artikel

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. Dies bedeutet, dass das Objekt so lange am Leben bleiben muss, wie diese externe Verbindung besteht. 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 soll nur zu Debugzwecken verwendet werden.

Hinweise

Wenn fLastReleaseCloses gleich TRUE ist, führt der Aufruf von ReleaseConnection dazu, dass das Objekt sich 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 wird.

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 objidlbase.h (include ObjIdl.h)

Weitere Informationen

IExternalConnection