System.IUnknown.AddRef

De RAD Studio API Documentation
Aller à : navigation, rechercher

C++

virtual ULONG STDMETHODCALLTYPE AddRef( void) = 0;

Propriétés

Type Visibilité  Source Unité  Parent
function public unknwn.h System IUnknown


Description

Incrémente le nombre de références de cette interface.

Dans la plupart des implémentations, AddRef incrémente le nombre de références de l'interface et renvoie le nouveau nombre de références. Lorsque l'appelant n'a plus besoin de l'interface, l'utilisateur doit appeler la méthode Release qui décrémente le nombre de références. Lorsque le nombre de références atteint zéro, l'objet est automatiquement libéré.

Remarques :

  • Les objets d'implémentation peuvent implémenter AddRef et Release afin qu'elles ne procèdent à aucun comptage de références. Dans le cas de tels objets, le nombre de références n'atteint jamais zéro et l'objet n'est pas automatiquement libéré. Dans ces situations, il appartient à l'application de libérer l'objet.
  • Appelez cette méthode pour chaque nouvelle copie de ce pointeur d'interface que vous créez.

Voir aussi