Marshal.FinalReleaseComObject(Object) Metoda
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
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 -> intstatic member FinalReleaseComObject : obj -> intPublic Shared Function FinalReleaseComObject (o As Object) As IntegerParametry
- 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.
o je null.
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.
