Marshal.FinalReleaseComObject(Object) Metoda

Odwołanie

Definicja

Przestrzeń nazw:: System.Runtime.InteropServices

Zestaw:: System.Runtime.InteropServices.dll

Zestaw:: mscorlib.dll

Zestaw:: netstandard.dll

Źródło:: Marshal.NoCom.cs

Źródło:: Marshal.NoCom.cs

Źródło:: Marshal.NoCom.cs

Ważne

Niektóre informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany przed wydaniem. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Zwalnia wszystkie odwołania do środowiska uruchomieniowego Callable Wrapper (RCW), ustawiając jej liczbę odwołań na 0.

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

Parametry

o: Object

Wersja RCW, która ma zostać wydana.

Zwraca

Int32

Nowa wartość liczby odwołań RCW skojarzonej z parametrem o , czyli 0 (zero), jeśli wydanie zakończy się pomyślnie.

Atrybuty: SecurityCriticalAttribute SupportedOSPlatformAttribute

Wyjątki

ArgumentException

o jest nieprawidłowym obiektem COM.

ArgumentNullException

o to null.

Uwagi

Metoda FinalReleaseComObject zwalnia zarządzane odwołanie do obiektu COM. Wywołanie tej metody jest równoważne wywołaniu ReleaseComObject metody w pętli, dopóki nie zwróci wartości 0 (zero).

Gdy liczba odwołań dla obiektu COM staje się 0, obiekt COM jest zwykle zwalniany, chociaż zależy to od implementacji obiektu COM i wykracza poza kontrolę środowiska uruchomieniowego. Jednak RCW nadal może istnieć, czekając na śmieci zebrane.

Nie można użyć obiektu COM po oddzieleniu go od bazowej wersji RCW. Jeśli spróbujesz wywołać metodę na RCW po jego liczbie odwołań zostanie 0, InvalidComObjectException zostanie zgłoszony.

Dotyczy