Marshal.AddRef(IntPtr) Méthode

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

Paramètres

Retours

Nouvelle valeur du décompte de références sur le paramètre pUnk.

Attributs

SecurityCriticalAttribute SupportedOSPlatformAttribute

Remarques

Le Common Language Runtime gère le nombre de références d’un objet COM pour vous, ce qui rend inutile l’utilisation directe de cette méthode. Dans de rares cas, comme le test d’un marshaleur personnalisé, il peut s’avérer nécessaire de manipuler manuellement la durée de vie d’un objet. Après avoir appelé AddRef, vous devez décrémenter le nombre de références à l’aide d’une méthode telle que Marshal.Release. Ne vous fiez pas à la valeur de retour de AddRef, car elle peut parfois être instable.

Vous pouvez appeler Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject pour obtenir une IntPtr valeur qui représente un pointeur d’interface IUnknown . Vous pouvez également utiliser ces méthodes et la AddRef méthode sur les objets managés pour obtenir les interfaces COM représentées par le wrapper COM callable de l’objet managé. Si vous n’êtes pas familiarisé avec les détails de ce type de wrapper, consultez COM Callable Wrapper.

S’applique à

Voir aussi

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