Marshal.ReleaseComObject(Object) メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
指定した COM オブジェクトに関連付けられている ランタイム呼び出し可能ラッパー (RCW) の参照カウントをデクリメントします。
public:
static int ReleaseComObject(System::Object ^ o);[System.Security.SecurityCritical]
public static int ReleaseComObject(object o);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int ReleaseComObject(object o);public static int ReleaseComObject(object o);[<System.Security.SecurityCritical>]
static member ReleaseComObject : obj -> int[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member ReleaseComObject : obj -> intstatic member ReleaseComObject : obj -> intPublic Shared Function ReleaseComObject (o As Object) As Integerパラメーター
- o
- Object
解放する COM オブジェクト。
返品
oに関連付けられている RCW の参照カウントの新しい値。 RCW は、呼び出すマネージド クライアントの数に関係なく、ラップされた COM オブジェクトへの参照を 1 つだけ保持するため、通常、この値は 0 です。
- 属性
例外
o が有効な COM オブジェクトではありません。
o は nullです。
注釈
このメソッドは、マネージド コードから使用される COM オブジェクトの有効期間を明示的に制御するために使用されます。 このメソッドを使用して、リソースへの参照をタイムリーに保持する、またはオブジェクトを特定の順序で解放する必要がある場合に、基になる COM オブジェクトを解放する必要があります。
COM インターフェイス ポインターが共通言語ランタイム (CLR) に入るたびに、RCW にラップされます。
RCW には、COM インターフェイス ポインターがマップされるたびにインクリメントされる参照カウントがあります。 ReleaseComObjectメソッドは、RCW の参照カウントをデクリメントします。 参照カウントが 0 に達すると、ランタイムはアンマネージ COM オブジェクトのすべての参照を解放し、オブジェクトをさらに使用しようとすると System.NullReferenceException をスローします。 同じ COM インターフェイスがアンマネージド コードからマネージド コードに複数回渡された場合、ラッパーの参照カウントは毎回インクリメントされ、 ReleaseComObject 呼び出しは残りの参照の数を返します。
このメソッドを使用すると、RCW 参照カウントを強制的に解放して、必要なときに正確に実行されるようにすることができます。 ただし、 ReleaseComObject を不適切に使用すると、アプリケーションが失敗したり、アクセス違反が発生したりする可能性があります。
アプリケーション ドメイン内のマネージド コードが、COM コンポーネントを表す RCW を保持しているシナリオについて考えてみましょう。 RCW で ReleaseComObject メソッドを呼び出すと、マネージド コードは RCW にアクセスできず、 InvalidComObjectException 例外が発生します。
RCW のリリース時に RCW の呼び出しが実行されている場合は、より重大なエラーが発生する可能性があります。 この場合、呼び出しを行うスレッドがアクセス違反を引き起こす可能性が高くなります。 ただし、プロセス メモリが破損し、デバッグが非常に困難な理由で失敗するまでプロセスが実行され続ける可能性があります。
このリスクは、使用されている COM コンポーネントがシングルトンである場合に複合されます。次の理由により、CLR は COM CoCreateInstance 関数を呼び出して COM コンポーネントをアクティブ化します。この関数は、シングルトン COM コンポーネントに対して呼び出されるたびに同じインターフェイス ポインターを返します。 したがって、アプリケーション ドメイン内の個別の独立したマネージド コードは、シングルトン COM コンポーネントに対して同じ RCW を使用でき、どちらか一方が COM コンポーネントで ReleaseComObject メソッドを呼び出すと、もう一方が破損します。
したがって、 ReleaseComObject が絶対に必要な場合にのみ使用してください。 このメソッドを呼び出して、決定された時刻に COM コンポーネントが確実に解放されるようにする場合は、代わりに FinalReleaseComObject メソッドを使用することを検討してください。 FinalReleaseComObject は、CLR に再入力した回数に関係なく、基になる COM コンポーネントを解放します。 RCW の内部参照カウントは、COM コンポーネントが CLR に再入力するたびに 1 ずつインクリメントされます。 したがって、返される値が 0 になるまで、ループ内で ReleaseComObject メソッドを呼び出す可能性があります。 これにより、 FinalReleaseComObject メソッドと同じ結果が得られます。
