System.Variants.TCustomVariantType._AddRef
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.