Marshal.AddRef(IntPtr) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Incrémente le décompte de références sur l'interface spécifiée.
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
- pUnk
-
IntPtr
nativeint
Décompte de références d'interface à incrémenter.
Retours
Nouvelle valeur du décompte de références sur le paramètre pUnk
.
- Attributs
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 vous fiez pas à la valeur de AddRefretour , 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 COM pouvant être appelé par l’objet managé. Si vous n’êtes pas familiarisé avec les détails de ce type de wrapper, consultez WRAPPER POUVANT ÊTRE APPELÉ COM.