Méthode IUnknown::AddRef (unknwn.h)

  • Article

Incrémente le nombre de références pour un pointeur d’interface vers un objet COM. Vous devez appeler cette méthode chaque fois que vous effectuez une copie d’un pointeur d’interface

Syntaxe

ULONG AddRef();

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

Un objet COM utilise un mécanisme de comptage de références par interface pour s’assurer que l’objet ne surviv pas aux références à celui-ci. Vous utilisez AddRef pour stabiliser une copie d’un pointeur d’interface. Il peut également être appelé lorsque la durée de vie d’un pointeur cloné doit dépasser la durée de vie du pointeur d’origine. Le pointeur cloné doit être libéré en appelant IUnknown::Release dessus.

Le compteur de référence interne qu’AddRef gère doit être un entier non signé 32 bits.

Remarques aux appelants

Appelez cette méthode pour chaque nouvelle copie d’un pointeur d’interface que vous créez. Par exemple, si vous retournez une copie d’un pointeur à partir d’une méthode, vous devez appeler AddRef sur ce pointeur. Vous devez également appeler AddRef sur un pointeur avant de le passer en tant que paramètre in-out à une méthode ; la méthode appelle IUnknown::Release avant de copier la valeur de sortie par-dessus.

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