IUnknown::Release, méthode (unknwn.h)
Décrémente le nombre de références d’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.
Notes
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 référence (anciennement) en attente à un objet (si l’objet prend en charge des interfaces uniques ou multiples), 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.
Notes pour les appelants
Appelez cette méthode lorsque vous n’avez plus besoin d’utiliser un 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 hors valeur en haut de celle-ci.
Configuration requise
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 |