Sdílet prostřednictvím


Marshal.FinalReleaseComObject(Object) Metoda

Definice

Uvolní všechny odkazy na modul Runtime Callable Wrapper (RCW) nastavením počtu odkazů na hodnotu 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, který se má vydat.

Návraty

Nová hodnota referenčního počtu RCW přidruženého k parametru o , který je 0 (nula), pokud je vydání úspěšné.

Atributy

Výjimky

o není platný objekt COM.

Poznámky

Metoda FinalReleaseComObject uvolní spravovaný odkaz na objekt COM. Volání této metody je ekvivalentní volání ReleaseComObject metody ve smyčce, dokud nevrátí hodnotu 0 (nula).

Když se počet odkazů na objekt COM změní na hodnotu 0, objekt COM je obvykle uvolněn, i když to závisí na implementaci objektu COM a je mimo kontrolu modulu runtime. RcW však může stále existovat a čeká na uvolnění paměti.

Objekt COM nelze použít poté, co byl oddělen od jeho podkladové RCW. Pokud se pokusíte volat metodu na RCW poté, co se počet odkazů změní na 0, InvalidComObjectException vyvolá se.

Platí pro

Viz také