Marshal.AddRef(IntPtr) Método

Referencia

Definición

Espacio de nombres:: System.Runtime.InteropServices

Ensamblado:: System.Runtime.InteropServices.dll

Ensamblado:: mscorlib.dll

Ensamblado:: netstandard.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Incrementa el contador de referencia en la interfaz especificada.

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

Parámetros

pUnk: IntPtr
nativeint

Contador de referencia de la interfaz a incrementar.

Devoluciones

Int32

Nuevo valor del contador de referencias en el parámetro pUnk.

Atributos: SecurityCriticalAttribute SupportedOSPlatformAttribute

Comentarios

Common Language Runtime administra el recuento de referencias de un objeto COM, lo que hace que no sea necesario usar este método directamente. En raras ocasiones, como probar un serializador personalizado, es posible que sea necesario manipular la duración de un objeto manualmente. Después de llamar a AddRef, debe reducir el recuento de referencias mediante un método como Marshal.Release. No confíe en el valor devuelto de AddRef, ya que a veces puede ser inestable.

Puede llamar a Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecto Marshal.GetIDispatchForObject para obtener un IntPtr valor que representa un puntero de interfaz IUnknown . También puede usar estos métodos y el AddRef método en objetos administrados para obtener las interfaces COM representadas por el contenedor al que se puede llamar COM del objeto administrado. Si no está familiarizado con los detalles de este tipo de contenedor, consulte Contenedor al que se puede llamar COM.

Se aplica a