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

Voir aussi