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

Article
03/04/2024

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objidl.h (inclure ObjIdl.h)

Voir aussi

IExternalConnection

Partager via