Marshal.AddRef(IntPtr) メソッド

定義

名前空間:
System.Runtime.InteropServices
アセンブリ:
mscorlib.dll, System.Runtime.InteropServices.dll
アセンブリ:
netstandard.dll, System.Runtime.InteropServices.dll
アセンブリ:
System.Runtime.InteropServices.dll
アセンブリ:
mscorlib.dll
アセンブリ:
netstandard.dll
ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
Marshal.cs
ソース:
Marshal.cs

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

public:
 static int AddRef(IntPtr pUnk);
[System.Security.SecurityCritical]
public static int AddRef(IntPtr pUnk);
public static int AddRef(IntPtr pUnk);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef(IntPtr pUnk);
[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> int
static member AddRef : nativeint -> int
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> int
Public Shared Function AddRef (pUnk As IntPtr) As Integer

パラメーター

pUnk
IntPtr

nativeint

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

返品

Int32

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

属性
SecurityCriticalAttribute SupportedOSPlatformAttribute

注釈

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

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

適用対象

こちらもご覧ください