System.Variants.TCustomVariantType._AddRef

De RAD Studio API Documentation
Aller à : navigation, rechercher

Delphi

function _AddRef: Integer; stdcall;

C++

int __stdcall _AddRef();

Propriétés

Type Visibilité  Source Unité  Parent
function protected
System.Variants.pas
System.Variants.hpp
System.Variants TCustomVariantType


Description

Répond lorsque l'appelant obtient une référence à l'interface de cet objet.

Lorsqu'une application utilise une interface implémentée par TCustomVariantType ou l'un de ses descendants, elle appelle automatiquement __AddRef. Généralement, les objets interfacés utilisent la méthode __AddRef pour incrémenter un compteur de références, qui est décrémenté lorsque l'application libère l'interface. Dans ce scénario ordinaire, lorsque le compteur de référence affiche zéro, l'objet se libère lui-même.

TCustomVariantType implémente sa propre version des méthodes IInterface __AddRef et _Release afin d'éviter ce comportement classique. Une application ne doit compter qu'une seule instance de TCustomVariantType, qui ne doit pas se libérer automatiquement lorsqu'elle n'est pas utilisée. Par conséquent, TCustomVariantType implémente __AddRef de telle sorte qu'elle renvoie toujours–1.

Voir aussi