Marshal.FinalReleaseComObject(Object) Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

netstandard.dll, System.Runtime.InteropServices.dll

Zdroj:

Marshal.NoCom.cs

Uvolní všechny odkazy na obálku s možností volání modulu runtime (RCW) nastavením počtu odkazů na 0.

public:
 static int FinalReleaseComObject(System::Object ^ o);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int FinalReleaseComObject(object o);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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ých k parametru o , který je 0 (nula), pokud je vydání úspěšné.

Atributy

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 stane 0, objekt COM je obvykle uvolněn, ačkoli to závisí na implementaci objektu COM a je nad kontrolou modulu runtime. RcW však stále existuje a čeká na uvolnění paměti.

Objekt COM nelze použít poté, co byl oddělen od jeho základní rcW. Pokud se pokusíte volat metodu rcW po jeho referenčním počtu 0, InvalidComObjectException vyvolá se vyvolá.

Viz také

• ReleaseComObject(Object)
• NullReferenceException