Marshal.FinalReleaseComObject(Object) Metoda
Definicja
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 przez środowisko uruchomieniowe (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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParametry
- o
- Object
RcW do wydania.
Zwraca
Nowa wartość liczby odwołań RCW skojarzonej z parametrem o , czyli 0 (zero), jeśli wydanie zakończy się pomyślnie.
- Atrybuty
Wyjątki
o jest nieprawidłowym obiektem COM.
Parametr o ma wartość 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 może nadal istnieć, czekając na odzyskiwanie pamięci.
Nie można użyć obiektu COM po oddzieleniu go od jego bazowego RCW. Jeśli spróbujesz wywołać metodę w wersji RCW po jej liczbie odwołań, zostanie zgłoszony błąd InvalidComObjectException 0.
