Marshal.AddRef(IntPtr) メソッド

定義

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

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

パラメーター

pUnk
IntPtr

nativeint

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

戻り値

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

属性

注釈

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

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

適用対象

こちらもご覧ください