System.Variants.TCustomVariantType._AddRef

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche


Delphi

function _AddRef: Integer; stdcall;

C++

int __stdcall _AddRef();

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function protected
System.Variants.pas
System.Variants.hpp
System.Variants TCustomVariantType

Beschreibung

Reagiert, wenn der Aufrufer eine Referenz auf die Schnittstelle des Objekts anfordert.

Verwendet eine Anwendung eine Schnittstelle, die von TCustomVariantType oder einem Nachkommen implementiert wurde, ruft sie automatisch __AddRef auf. Normalerweise erhöhen Objekte, auf die über eine Schnittstelle zugegriffen wird, einen Referenzzähler, der verringert wird, wenn die Anwendung die Schnittstelle freigibt. In diesem typischen Szenario gibt sich das Objekt selbst frei, wenn der Referenzzähler den Wert Null erreicht.

TCustomVariantType implementiert eine eigene Version der IInterface-Methoden __AddRef und _Release, die dieses typische Verhalten umgehen. Eine Anwendung sollte nur eine einzelne Instanz von TCustomVariantType enthalten. Diese Instanz soll nicht automatisch freigegeben werden, wenn sie nicht benutzt wird. Aus diesem Grund ist __AddRef in TCustomVariantType so implementiert, dass immer -1 zurückgegeben wird.

Siehe auch