Marshal.FinalReleaseComObject(Object) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Marshal.NoCom.cs

Quelle:: Marshal.NoCom.cs

Quelle:: Marshal.NoCom.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Security.SecurityCritical]
public static int FinalReleaseComObject (object o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject (object o);

public static int FinalReleaseComObject (object o);

[<System.Security.SecurityCritical>]
static member FinalReleaseComObject : obj -> int

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member FinalReleaseComObject : obj -> int

static member FinalReleaseComObject : obj -> int

Public Shared Function FinalReleaseComObject (o As Object) As Integer

Parameter

o: Object

Der RCW, der freigegeben werden soll.

Gibt zurück

Int32

Der neue Wert des Verweiszählers des RCWs, der dem o-Parameter zugeordnet ist. Dieser ist bei erfolgreicher Freigabe 0 (null).

Attribute: SecurityCriticalAttribute SupportedOSPlatformAttribute

Ausnahmen

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 sie 0 (null) zurückgibt.

Wenn die Verweisanzahl für das COM-Objekt 0 wird, wird das COM-Objekt in der Regel freigegeben, obwohl dies von der Implementierung des COM-Objekts abhängt und außerhalb der Kontrolle der Laufzeit liegt. Der RCW kann jedoch weiterhin vorhanden sein und darauf warten, dass die Garbage Collection erfolgt.

Das COM-Objekt kann nicht verwendet werden, nachdem es von seinem zugrunde liegenden RCW getrennt wurde. Wenn Sie versuchen, eine Methode für den RCW aufzurufen, nachdem die Verweisanzahl 0 ist, wird eine InvalidComObjectException ausgelöst.

Gilt für: