Méthode IUnknown ::Release (unknwn.h)
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 |