Méthode IExternalConnection ::ReleaseConnection (objidlbase.h)

Décrémente le nombre de connexions externes fortes d’un objet.

Syntaxe

DWORD ReleaseConnection(
  [in] DWORD extconn,
  [in] DWORD reserved,
  [in] BOOL  fLastReleaseCloses
);

Paramètres

[in] extconn

Type de connexion externe à l’objet. Le seul type de connexion externe actuellement pris en charge par cette interface est fort, ce qui signifie que l’objet doit rester actif tant que cette connexion externe existe. Les connexions externes fortes sont représentées par la valeur EXTCONN_STRONG, qui est définie dans l’énumération EXTCONN.

[in] reserved

Informations sur la connexion. Ce paramètre est réservé à l’utilisation par OLE. Sa valeur peut être égale à zéro, mais pas nécessairement. Par conséquent, les implémentations de ReleaseConnection ne doivent pas contenir de blocs de code dont l’exécution dépend du retour ou non d’une valeur zéro.

[in] fLastReleaseCloses

Ce paramètre a la valeur TRUE si la connexion en cours de libération est le dernier verrou externe sur l’objet, et par conséquent, l’objet doit se fermer. Sinon, l’objet doit rester ouvert jusqu’à ce qu’il soit fermé par l’utilisateur ou un autre processus.

Valeur retournée

La méthode retourne le nombre de connexions. Cette valeur est destinée à être utilisée uniquement à des fins de débogage.

Remarques

Si fLastReleaseCloses est égal à TRUE, l’appel de ReleaseConnection entraîne l’arrêt de l’objet. L’appel de cette méthode est la seule façon dont un objet DLL, exécuté dans le même espace de processus que l’application conteneur, saura quand se fermer après une mise à jour silencieuse.

Configuration requise

Voir aussi

IExternalConnection