Marshal.FinalReleaseComObject(Object) メソッド

定義

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

ランタイム呼び出し可能ラッパー (RCW) の参照カウントを 0 に設定することによって、RCW へのすべての参照を解放します。

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

解放する RCW。

Int32

RCW の参照カウントの新しい値に関連付けられている、o パラメーターで、このリリースでは、成功した場合は 0 (ゼロ)。

o は有効な COM オブジェクトではありません。

o が nullです。

メソッドは FinalReleaseComObject 、COM オブジェクトへのマネージド参照を解放します。このメソッドを呼び出すことは、0 (ゼロ) を返すまでループでメソッドを呼び出 ReleaseComObject すことと同じです。

COM オブジェクトの参照カウントが 0 になると、COM オブジェクトは通常解放されますが、これは COM オブジェクトの実装に依存し、ランタイムの制御を超えています。ただし、RCW は引き続き存在し、ガベージコレクションを待機しています。

COM オブジェクトは、基になる RCW から分離された後は使用できません。参照カウントが 0 になった後に RCW でメソッドを呼び出そうとすると、 InvalidComObjectException がスローされます。