IExternalConnection::ReleaseConnection-Methode (objidl.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, 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)

Weitere Informationen

IExternalConnection