Méthode IUnknown ::Release (unknwn.h)

  • Article

Décrémente le nombre de références pour une interface sur un objet COM.

Syntaxe

ULONG Release();

Valeur de retour

La méthode retourne le nouveau nombre de références. Cette valeur est destinée à être utilisée uniquement à des fins de test.

Remarques

Lorsque le nombre de références sur un objet atteint zéro, Release doit entraîner la libération du pointeur d’interface. Lorsque le pointeur libéré est la seule (anciennement) référence en suspens à un objet (si l’objet prend en charge une ou plusieurs interfaces), l’implémentation doit libérer l’objet.

Notez que l’agrégation d’objets limite la possibilité de récupérer des pointeurs d’interface.

Remarques aux appelants

Appelez cette méthode lorsque vous n’avez plus besoin d’utiliser de pointeur d’interface. Si vous écrivez une méthode qui prend un paramètre in-out, appelez Release sur le pointeur que vous transmettez avant de copier la valeur de sortie par-dessus.

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 unknwn.h

Voir aussi