Méthode IExternalConnection ::ReleaseConnection (objidl.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 nulle.

[in] fLastReleaseCloses

Ce paramètre a la valeur TRUE si la connexion libérée est le dernier verrou externe de l’objet et que l’objet doit donc 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 pour un objet DLL, s’exécutant dans le même espace de processus que l’application conteneur, de savoir quand se fermer après une mise à jour en mode silencieux.

Configuration requise

Voir aussi

IExternalConnection