Marshal.AddRef(IntPtr) メソッド

定義

指定したインターフェイスの参照カウントをインクリメントします。

C#
[System.Security.SecurityCritical]
public static int AddRef (IntPtr pUnk);
C#
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef (IntPtr pUnk);
C#
public static int AddRef (IntPtr pUnk);

パラメーター

pUnk
IntPtr

インクリメントするインターフェイスの参照カウント。

戻り値

pUnk パラメーターの参照カウントの新しい値。

属性

注釈

共通言語ランタイムは COM オブジェクトの参照カウントを自動的に管理するため、このメソッドを直接使用する必要は不要です。 まれに、カスタム マーシャラーのテストなど、オブジェクトの有効期間を手動で操作する必要がある場合があります。 を呼び出 AddRefした後、 などの Marshal.Releaseメソッドを使用して参照カウントをデクリメントする必要があります。 不安定な場合があるため、 の AddRef戻り値に依存しないでください。

Marshal.GetIUnknownForObject、または Marshal.GetIDispatchForObject を呼び出Marshal.GetComInterfaceForObjectして、IntPtrIUnknown インターフェイス ポインターを表す値を取得できます。 これらのメソッドとマネージド オブジェクトの メソッドを AddRef 使用して、マネージド オブジェクトの COM 呼び出し可能ラッパーによって表される COM インターフェイスを取得することもできます。 このラッパーの種類の詳細に慣れていない場合は、「 COM 呼び出し可能ラッパー」を参照してください。

適用対象

製品 バージョン
.NET Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP 10.0

こちらもご覧ください