Marshal.FinalReleaseComObject-Methode: (Object)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Gibt alle Verweise auf einen Runtime Callable Wrapper (RCW) durch Festlegen des Verweiszählers auf 0 frei.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

[SecurityCriticalAttribute]
public static int FinalReleaseComObject(
    object o
)

public:
[SecurityCriticalAttribute]
static int FinalReleaseComObject(
    Object^ o
)

[<SecurityCriticalAttribute>]
static member FinalReleaseComObject : 
        o:Object -> int

<SecurityCriticalAttribute>
Public Shared Function FinalReleaseComObject (
    o As Object
) As Integer

Parameter

o
Type: System.Object

Der RCW, der freigegeben werden soll.

Rückgabewert

Type: System.Int32

Der neue Wert des Verweiszählers des RCWS zugeordneten der o-Parameter, der 0 (null) ist, wenn die Veröffentlichung erfolgreich war.

Ausnahmen

Exception	Condition
ArgumentException	o ist kein gültiges COM-Objekt.
ArgumentNullException	o ist null.

Hinweise

Die FinalReleaseComObject -Methode gibt den verwalteten Verweis auf ein COM-Objekt frei. Das Aufrufen dieser Methode entspricht dem Aufrufen der ReleaseComObject -Methode in einer Schleife, bis 0 (null) zurückgegeben.

Wenn der Verweiszähler für das COM-Objekt 0 wird, wird das COM-Objekt normalerweise freigegeben, obwohl dies hängt von der COM-Objekt-Implementierung und befindet sich außerhalb der Kontrolle der Laufzeit. Allerdings kann der RCW weiterhin vorhanden auf Garbage Collection warten.

Das COM-Objekt kann nicht verwendet werden, nachdem es vom zugrunde liegenden RCW getrennt wurde. Wenn Sie versuchen, eine Methode auf dem RCW aufzurufen, nachdem sein Verweiszähler 0 ist, wird eine InvalidComObjectException ausgelöst.

Sicherheit

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 2.0
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone Silverlight
Verfügbar seit 8.0
Windows Phone
Verfügbar seit 8.1

Siehe auch

ReleaseComObject
NullReferenceException
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang

Freigeben über