Marshal.AddRef(IntPtr) 方法
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
遞增指定介面的參考次數 (Reference Count)。
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
參數上的參考次數的新值。
- 屬性
Common Language Runtime 會為您管理 COM 對象的參考計數,因此不需要直接使用此方法。 在少數情況下,例如測試自定義封送處理器,您可能會發現需要手動操作物件的存留期。 呼叫 AddRef之後,您必須使用 之類的 Marshal.Release方法來遞減參考計數。 請勿依賴 的 AddRef傳回值,因為有時可能不穩定。
您可以呼叫 Marshal.GetComInterfaceForObject、 Marshal.GetIUnknownForObject或 Marshal.GetIDispatchForObject 來取得 IntPtr 代表 IUnknown 介面指標的值。 您也可以使用這些方法和 Managed 物件上的 方法 AddRef ,以取得 Managed 物件的 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 |