Marshal.AddRef(IntPtr) 方法

定義

命名空間:

System.Runtime.InteropServices

組件:

System.Runtime.InteropServices.dll

來源:

Marshal.cs

遞增指定介面的參考次數 (Reference Count)。

public:
 static int AddRef(IntPtr pUnk);

public static int AddRef (IntPtr pUnk);

static member AddRef : nativeint -> int

Public Shared Function AddRef (pUnk As IntPtr) As Integer

參數

pUnk

IntPtr

nativeint

要遞增的介面參考次數。

傳回

Int32

pUnk 參數上的參考次數的新值。

備註

Common Language Runtime 會為您管理 COM 物件的參考計數，因此不需要直接使用此方法。 在少數情況下，例如測試自訂封送處理器，您可能會發現需要手動操作物件的存留期。 呼叫 AddRef 之後，您必須使用 之類的 Marshal.Release 方法來遞減參考計數。 請勿依賴 的 AddRef 傳回值，因為有時可能不穩定。

您可以呼叫 Marshal.GetComInterfaceForObject 、 Marshal.GetIUnknownForObject 或 Marshal.GetIDispatchForObject 來取得 IntPtr 代表 IUnknown 介面指標的值。 您也可以使用這些方法和 Managed 物件上的 方法 AddRef ，以取得 Managed 物件的 COM 可呼叫包裝函式所代表的 COM 介面。 如果您不熟悉此包裝函式類型的詳細資料，請參閱 COM 可呼叫包裝函式。

另請參閱

• Release(IntPtr)
• QueryInterface(IntPtr, Guid, IntPtr)
• GetComInterfaceForObject(Object, Type)
• GetIUnknownForObject(Object)
• GetIDispatchForObject(Object)
• IUnknown：：AddRef