IUnknown::AddRef-Methode (unknwn.h)

  • Artikel

Erhöht die Verweisanzahl für einen Schnittstellenzeiger auf ein COM-Objekt. Sie sollten diese Methode aufrufen, wenn Sie eine Kopie eines Schnittstellenzeigers erstellen.

Syntax

ULONG AddRef();

Rückgabewert

Die -Methode gibt die neue Verweisanzahl zurück. Dieser Wert ist nur für Testzwecke vorgesehen.

Hinweise

Ein COM-Objekt verwendet einen Mechanismus für die Referenzzählung pro Schnittstelle, um sicherzustellen, dass das Objekt keine überdauerten Verweise darauf enthält. Sie verwenden AddRef , um eine Kopie eines Schnittstellenzeigers zu stabilisieren. Er kann auch aufgerufen werden, wenn die Lebensdauer eines geklonten Zeigers über die Lebensdauer des ursprünglichen Zeigers hinausgehen muss. Der geklonte Zeiger muss freigegeben werden, indem IUnknown::Release aufgerufen wird.

Der interne Verweisindikator, den AddRef verwaltet, sollte eine 32-Bit-Ganzzahl ohne Vorzeichen sein.

Notizen für Anrufer

Rufen Sie diese Methode für jede neue Kopie eines Schnittstellenzeigers auf, die Sie erstellen. Wenn Sie beispielsweise eine Kopie eines Zeigers von einer -Methode zurückgeben, müssen Sie AddRef für diesen Zeiger aufrufen. Sie müssen auch AddRef für einen Zeiger aufrufen, bevor Sie ihn als In-Out-Parameter an eine -Methode übergeben. die -Methode ruft IUnknown::Release auf, bevor sie den Out-Value oben kopiert.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile unknwn.h

Weitere Informationen