Marshal.AddRef(IntPtr) Méthode

public:
 static int AddRef(IntPtr pUnk);

[System.Security.SecurityCritical]
public static int AddRef(IntPtr pUnk);

public static int AddRef(IntPtr pUnk);

[<System.Security.SecurityCritical>]
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 nombre de références sur le pUnk paramètre.

Attributs

SecurityCriticalAttribute

Remarques

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

Vous pouvez appeler Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject 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 POUVANT appeler COM de l’objet managé. Si vous n’êtes pas familiarisé avec les détails de ce type de wrapper, consultez com Callable Wrapper.

Voir aussi

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