Marshal.FinalReleaseComObject(Object) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Publiceert alle verwijzingen naar een Runtime Callable Wrapper (RCW) door het aantal verwijzingen in te stellen op 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 IntegerParameters
- o
- Object
De RCW die moet worden vrijgegeven.
Retouren
De nieuwe waarde van het referentieaantal van de RCW die aan de o parameter is gekoppeld, is 0 (nul) als de release is geslaagd.
- Kenmerken
Uitzonderingen
o is geen geldig COM-object.
o is null.
Opmerkingen
Met de FinalReleaseComObject methode wordt de beheerde verwijzing naar een COM-object vrijgegeven. Het aanroepen van deze methode is gelijk aan het aanroepen van de ReleaseComObject methode in een lus totdat deze 0 (nul) retourneert.
Wanneer het aantal verwijzingen op het COM-object 0 wordt, wordt het COM-object meestal vrijgemaakt, hoewel dit afhankelijk is van de implementatie van het COM-object en buiten de controle van de runtime valt. De RCW kan echter nog steeds bestaan, wachtend op garbagecollection.
Het COM-object kan niet worden gebruikt nadat het is gescheiden van de onderliggende RCW. Als u een methode op de RCW probeert aan te roepen nadat het aantal verwijzingen 0 is, wordt er een InvalidComObjectException gegenereerd.
