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 ś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 -> 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 , który jest równy 0 (zero), jeśli wydanie zakończy się pomyślnie.
- Atrybuty
Wyjątki
o jest nieprawidłowym obiektem COM.
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 .
