Marshal.FinalReleaseComObject(Object) Metoda

Reference

Definice

Obor názvů:: System.Runtime.InteropServices

Sestavení:: System.Runtime.InteropServices.dll

Sestavení:: mscorlib.dll

Sestavení:: netstandard.dll

Zdroj:: Marshal.NoCom.cs

Zdroj:: Marshal.NoCom.cs

Zdroj:: Marshal.NoCom.cs

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 -> 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

Int32

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: SecurityCriticalAttribute SupportedOSPlatformAttribute

Výjimky

ArgumentException

o není platný objekt COM.

ArgumentNullException

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, jakmile 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