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 otoki wywoływanej środowiska uruchomieniowego (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

RcW do wydania.

Zwraca

Int32

Nowa wartość liczby odwołań RCW skojarzonej z parametrem o , który jest równy 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ływanie 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ń do 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 może nadal istnieć, czekając na odzyskiwanie pamięci.

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

Dotyczy

Udostępnij za pośrednictwem