IUnknown::Release-Methode (unknwn.h)
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 |