Marshal.ReleaseComObject メソッド

.NET Framework クラス ライブラリ リファレンス

Marshal.ReleaseComObject メソッド

提供されたランタイム呼び出し可能ラッパーの参照カウントをデクリメントします。

名前空間: System.Runtime.InteropServices
アセンブリ: mscorlib (mscorlib.dll 内)
構文

Visual Basic (宣言)

Public Shared Function ReleaseComObject
 ( _
    o As Object _
) As Integer

Visual Basic (使用法)

Dim o As Object
Dim returnValue As Integer

returnValue = Marshal.ReleaseComObject(o)

C#

public static int ReleaseComObject
 (
    Object o
)

C++

public:
static int ReleaseComObject (
    Object^ o
)

J#

public static int ReleaseComObject
 (
    Object o
)

JScript

public static function ReleaseComObject
 (
    o : Object
) : int

パラメータ

o

解放する COM オブジェクト。

戻り値
o に関連付けられているランタイム呼び出し可能ラッパーの参照カウントの新しい値。この値は通常 0 となります。ランタイム呼び出し可能ラッパーは、ラップされた COM オブジェクトへの参照を、それを呼び出しているマネージ クライアントの数に関係なく、1 つしか保持しないためです。

例外

例外の種類	条件
ArgumentException	o が有効な COM オブジェクトではありません。 または o が null 参照 (Visual Basic では Nothing) です。

解説

COM インターフェイス ポインタは、共通言語ランタイムを入力するたびに、ランタイム呼び出し可能ラッパーにラップされます。このラッパーの機能の詳細については、「ランタイム呼び出し可能ラッパー」を参照してください。

このメソッドは、マネージ コードで使用する COM オブジェクトの有効期間を明示的に制御するために使用します。リソースへの参照を保持している、基になる COM オブジェクトを適切なタイミングで解放する必要がある場合、またはオブジェクトを特定の順序で解放する必要がある場合は、このメソッドを使用します。

ランタイム呼び出し可能ラッパーは、COM インターフェイス ポインタが割り当てられるたびにインクリメントされる参照カウントを保持しています。ReleaseComObject メソッドは、ランタイム呼び出し可能ラッパーの参照カウントをデクリメントします。参照カウントがゼロに到達すると、ランタイムはアンマネージ COM オブジェクトのすべての参照を解放し、この後でオブジェクトを使用しようとすると System.NullReferenceException をスローします。同じ COM インターフェイスがアンマネージ コードからマネージ コードに複数回渡された場合、ラッパーの参照カウントは毎回インクリメントされ、ReleaseComObject を呼び出すと、残りの参照の数が返されます。

メモ
ランタイム呼び出し可能ラッパーと元の COM オブジェクトが確実に解放されるようにするには、ループを作成し、返される参照カウントが 0 になるまで、ループの中でこのメソッドを呼び出します。

メモ
このメソッドは SecurityAction.LinkDemand を使用して、信頼関係のないコードからの呼び出しを防ぎます。SecurityPermissionAttribute.UnmanagedCode アクセス許可は、直前の呼び出し元にのみ要求されます。信頼性が一部しか確認されていないコードから呼び出すことができるコードの場合、ユーザー入力を検証せずに Marshal クラスに渡すことは避けてください。LinkDemand メンバの使用に関する重要な制約事項については、「Demand と LinkDemand」を参照してください。

.NET Framework のセキュリティ

• SecurityPermission  (アンマネージ コードを呼び出すために必要なアクセス許可)。 UnmanagedCode (関連する列挙体)。LinkDemand (セキュリティ アクション)。

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Mobile for Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Marshal クラス
Marshal メンバ
System.Runtime.InteropServices 名前空間
FinalReleaseComObject
NullReferenceException