Marshal.AddRef(IntPtr) Metode

Definisi

Ruang nama:

System.Runtime.InteropServices

Rakitan:

System.Runtime.InteropServices.dll

Sumber:

Marshal.cs

Menaikkan jumlah referensi pada antarmuka yang ditentukan.

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

Parameter

pUnk

IntPtr

nativeint

Jumlah referensi antarmuka untuk kenaikan.

Mengembalikan

Int32

Nilai baru dari jumlah referensi pada pUnk parameter .

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.

Lihat juga

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