Marshal.AddRef(IntPtr) Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

System.Runtime.InteropServices.dll

Source:

Marshal.cs

Incrementa el contador de referencia en la interfaz especificada.

public:
 static int AddRef(IntPtr pUnk);

public static int AddRef (IntPtr pUnk);

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.

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.

Consulte también

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