Marshal.AddRef(IntPtr) Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Zdroj:

Marshal.cs

Zvýší počet odkazů na zadané rozhraní.

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

Parametry

pUnk

IntPtr

nativeint

Počet odkazů na rozhraní pro zvýšení.

Návraty

Int32

Nová hodnota referenčního počtu v parametru pUnk .

Poznámky

Modul CLR (Common Language Runtime) spravuje počet odkazů objektu COM za vás, takže není nutné používat tuto metodu přímo. Ve výjimečných případech, jako je například testování vlastního zařazování, může být nutné ručně manipulovat s životností objektu. Po volání AddRefje nutné počet odkazů zvýšit pomocí metody, jako Marshal.Releaseje . Nespoléhejte na vrácenou hodnotu AddRef, protože někdy může být nestabilní.

Voláním , Marshal.GetIUnknownForObjectnebo Marshal.GetIDispatchForObject můžete Marshal.GetComInterfaceForObjectzískat IntPtr hodnotu, která představuje ukazatel rozhraní IUnknown. Můžete také použít tyto metody a metodu AddRef u spravovaných objektů k získání rozhraní MODELU COM reprezentovaných obálkou com volatelné objektu. Pokud nejste obeznámeni s podrobnostmi tohoto typu obálky, přečtěte si téma Obálka volatelného modelu COM.

Viz také

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