IUnknown::Release-Methode (unknwn.h)

  • Artikel

Verringert die Verweisanzahl für eine Schnittstelle für ein COM-Objekt.

Syntax

ULONG Release();

Rückgabewert

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

Hinweise

Wenn die Verweisanzahl für ein Objekt 0 erreicht, muss Release bewirken, dass sich der Schnittstellenzeiger selbst löst. Wenn der freigegebene Zeiger der einzige (früher) ausstehende Verweis auf ein Objekt ist (unabhängig davon, ob das Objekt einzelne oder mehrere Schnittstellen unterstützt), muss die Implementierung das Objekt freigeben.

Beachten Sie, dass die Aggregation von Objekten die Möglichkeit einschränkt, Schnittstellenzeiger wiederherzustellen.

Notizen für Anrufer

Rufen Sie diese Methode auf, wenn Sie keinen Schnittstellenzeiger mehr verwenden müssen. Wenn Sie eine Methode schreiben, die einen In-Out-Parameter akzeptiert, rufen Sie Release für den Zeiger auf, den Sie übergeben, bevor Sie den Out-Wert darüber kopieren.

Anforderungen

Anforderung Wert
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