Sdílet prostřednictvím


Marshal.AddRef(IntPtr) Metoda

Definice

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

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

Parametry

pUnk
IntPtr

nativeint

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

Návraty

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

Atributy

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.

Platí pro

Viz také