Export (0) Print
Expand All
Expand Minimize
1 out of 1 rated this helpful - Rate this topic

Marshal.FinalReleaseComObject Method

Releases all references to a Runtime Callable Wrapper (RCW) by setting its reference count to 0.

Namespace:  System.Runtime.InteropServices
Assembly:  mscorlib (in mscorlib.dll)
static member FinalReleaseComObject : 
        o:Object -> int 

Parameters

o
Type: System.Object
The RCW to be released.

Return Value

Type: System.Int32
The new value of the reference count of the RCW associated with the oparameter, which is 0 (zero) if the release is successful.
ExceptionCondition
ArgumentException

o is not a valid COM object.

ArgumentNullException

o is a null reference (Nothing in Visual Basic).

The FinalReleaseComObject method releases the managed reference to a COM object. Calling this method is equivalent to calling the ReleaseComObject method in a loop until it returns 0 (zero).

When the reference count on the COM object becomes 0, the COM object is usually freed, although this depends on the COM object's implementation and is beyond the control of the runtime. However, the RCW can still exist, waiting to be garbage-collected.

The COM object cannot be used after it has been separated from its underlying RCW. If you try to call a method on the RCW after its reference count becomes 0, a InvalidComObjectException will be thrown.

.NET Framework

Supported in: 4, 3.5, 3.0, 2.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1
  • SecurityCriticalAttribute 

    requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.