IUnknown::Release-Methode (unknwn.h)

Erhöht die Referenzanzahl für eine Schnittstelle auf einem COM-Objekt.

Syntax

ULONG Release();

Rückgabewert

Die Methode gibt die neue Referenzanzahl zurück. Dieser Wert soll nur für Testzwecke verwendet werden.

Hinweise

Wenn die Referenzanzahl eines Objekts null erreicht, muss Release dazu führen, dass der Schnittstellenzeiger selbst frei wird. Wenn der freigegebene Zeiger der einzige (früher) herausragende Verweis auf ein Objekt ist (ob das Objekt einzelne oder mehrere Schnittstellen unterstützt), muss die Implementierung das Objekt freistellen.

Beachten Sie, dass die Aggregation von Objekten die Möglichkeit zum Wiederherstellen von Schnittstellenzeigern beschränkt.

Notizen zu Anrufern

Rufen Sie diese Methode auf, wenn Sie keinen Schnittstellenzeiger mehr verwenden müssen. Wenn Sie eine Methode schreiben, die einen In-Out-Parameter verwendet, rufen Sie "Release " auf dem Zeiger auf, den Sie übergeben, bevor Sie den Wert oben kopieren.

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