Marshal.FinalReleaseComObject(Object) メソッド

定義

ランタイム呼び出し可能ラッパー (RCW) の参照カウントを 0 に設定することによって、RCW へのすべての参照を解放します。Releases all references to a Runtime Callable Wrapper (RCW) by setting its reference count to 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

パラメーター

o
Object

解放する RCW。The RCW to be released.

戻り値

Int32

RCW の参照カウントの新しい値に関連付けられている、o パラメーターで、このリリースでは、成功した場合は 0 (ゼロ)。The new value of the reference count of the RCW associated with the o parameter, which is 0 (zero) if the release is successful.

属性

例外

o は有効な COM オブジェクトではありません。o is not a valid COM object.

onullです。o is null.

注釈

メソッドは、 FinalReleaseComObject COM オブジェクトへのマネージ参照を解放します。The FinalReleaseComObject method releases the managed reference to a COM object. このメソッドを呼び出すことは、 ReleaseComObject 0 (ゼロ) を返すまでループ内でメソッドを呼び出すことと同じです。Calling this method is equivalent to calling the ReleaseComObject method in a loop until it returns 0 (zero).

COM オブジェクトの参照カウントが0になると、通常、com オブジェクトは解放されます。ただし、com オブジェクトの実装に依存し、ランタイムの制御を超えることはありません。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. ただし、RCW は依然として存在し、ガベージコレクションを待機している可能性があります。However, the RCW can still exist, waiting to be garbage-collected.

COM オブジェクトは、基になる RCW から分離された後で使用することはできません。The COM object cannot be used after it has been separated from its underlying RCW. 参照カウントが0になった後に RCW でメソッドを呼び出そうとすると、が InvalidComObjectException スローされます。If you try to call a method on the RCW after its reference count becomes 0, a InvalidComObjectException will be thrown.

適用対象

こちらもご覧ください