Marshal.AddRef(IntPtr) Método

Definición

Espacio de nombres:

System.Runtime.InteropServices

Ensamblado:

mscorlib.dll

Incrementa el recuento de referencias en la interfaz especificada.

public:
 static int AddRef(IntPtr pUnk);

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

[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> int

Public Shared Function AddRef (pUnk As IntPtr) As Integer

Parámetros

pUnk

IntPtr

nativeint

Recuento de referencias de interfaz que se va a incrementar.

Devoluciones

Int32

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

Atributos

SecurityCriticalAttribute

Comentarios

Common Language Runtime administra el recuento de referencias de un objeto COM por usted, 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 manualmente la duración de un objeto. Después de llamar a AddRef, debe disminuir 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 represente 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 com al que se puede llamar el objeto administrado. Si no está familiarizado con los detalles de este tipo de contenedor, consulte Contenedor invocable COM.

Consulte también

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