Bagikan melalui

Marshal.AddRef(IntPtr) Metode

  • Referensi

Definisi

Ruang nama:
System.Runtime.InteropServices
Rakitan:
System.Runtime.InteropServices.dll
Rakitan:
mscorlib.dll
Rakitan:
netstandard.dll
Sumber:
Marshal.cs
Sumber:
Marshal.cs
Sumber:
Marshal.cs

Menaikkan jumlah referensi pada antarmuka yang ditentukan.

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

Parameter

pUnk
IntPtr

nativeint

Jumlah referensi antarmuka untuk kenaikan.

Mengembalikan

Int32

Nilai baru dari jumlah referensi pada pUnk parameter .

Atribut
SecurityCriticalAttribute SupportedOSPlatformAttribute

Keterangan

Runtime bahasa umum mengelola jumlah referensi objek COM untuk Anda, sehingga tidak perlu menggunakan metode ini secara langsung. Dalam kasus yang jarang terjadi, seperti menguji marshaler kustom, Anda mungkin merasa perlu memanipulasi masa pakai objek secara manual. Setelah memanggil AddRef, Anda harus mengurangi jumlah referensi dengan menggunakan metode seperti Marshal.Release. Jangan mengandalkan nilai pengembalian , AddRefkarena terkadang tidak stabil.

Anda dapat memanggil Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject, atau Marshal.GetIDispatchForObject untuk mendapatkan IntPtr nilai yang mewakili penunjuk antarmuka IUnknown . Anda juga dapat menggunakan metode ini dan AddRef metode pada objek terkelola untuk mendapatkan antarmuka COM yang diwakili oleh pembungkus yang dapat dipanggil COM objek terkelola. Jika Anda tidak terbiasa dengan detail jenis pembungkus ini, lihat COM Callable Wrapper.

Berlaku untuk

Lihat juga