System.IUnknown.AddRef
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.