IInterface._AddRef Method

Increments the reference count for this interface.

Pascal

function _AddRef: Integer; stdcall;

C++

__fastcall __stdcall int _AddRef();

Description

The Delphi compiler automatically generates a call to __AddRef for every reference to this interface. For most implementations, __AddRef increments the reference count for the interface and returns the new reference count. When the caller is through with the interface, the compiler generates a call to the _Release method, which decrements the reference count. When the reference count drops to zero, the object is automatically freed.

Note: Implementation objects can implement __AddRef and _Release so that they do not perform any reference counting. For such objects, the reference count never drops to zero and the object is not automatically freed. In these cases, it is the application's responsibility to free the object.