Evaluar y enviar comentarios
Contraer todo/Expandir todo Contraer todo
Esta página es específica de
Microsoft Visual Studio 2005/.NET Framework 2.0

Hay además otras versiones disponibles para:
Biblioteca de clases de .NET Framework
Marshal.AddRef (Método)

Incrementa el contador de referencia en la interfaz especificada.

Espacio de nombres: System.Runtime.InteropServices
Ensamblado: mscorlib (en mscorlib.dll)

Visual Basic (Declaración)
Public Shared Function AddRef ( _
    pUnk As IntPtr _
) As Integer
Visual Basic (Uso)
Dim pUnk As IntPtr
Dim returnValue As Integer

returnValue = Marshal.AddRef(pUnk)
C#
public static int AddRef (
    IntPtr pUnk
)
C++
public:
static int AddRef (
    IntPtr pUnk
)
J#
public static int AddRef (
    IntPtr pUnk
)
JScript
public static function AddRef (
    pUnk : IntPtr
) : int

Parámetros

pUnk

Contador de referencia de la interfaz a incrementar.

Valor devuelto

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

Common Language Runtime administra el contador de referencias de un objeto COM, por lo que no es necesario utilizar este método directamente. En muy raras ocasiones, como cuando se prueba un contador de referencias personalizado, puede ser necesario manipular manualmente la duración de un objeto. Después de llamar a AddRef, debe disminuir el contador de referencias mediante un método como Marshal.Release. No se base en el valor devuelto por AddRef porque en ocasiones puede ser inestable.

Puede llamar a Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject o Marshal.GetIDispatchForObject para obtener un valor de IntPtr que represente un puntero de interfaz IUnknown. También puede utilizar estos métodos y el método AddRef en objetos administrados para obtener las interfaces COM representadas por el contenedor COM al que se puede llamar del objeto administrado. Si no está familiarizado con este tipo de contenedor, vea Contenedor COM al que se puede llamar. Para obtener más información sobre IUnknown::AddRef, vea MSDN Library.

NotaNota

Este método utiliza SecurityAction.LinkDemand para evitar que se le llame desde código que no sea de confianza; sólo el llamador inmediato debe disponer del permiso SecurityPermissionAttribute.UnmanagedCode. Si se puede llamar al código desde código de confianza parcial, no pase ninguna entrada de usuario a los métodos de la clase Marshal sin validación. Para conocer las limitaciones importantes que existen a la hora de utilizar el miembro LinkDemand, vea Demand frente a LinkDemand.

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium, Windows Mobile para Pocket PC, Windows Mobile para Smartphone, Windows Server 2003, Windows XP Media Center, Windows XP Professional x64, Windows XP SP2, Windows XP Starter Edition

.NET Framework no admite todas las versiones de cada plataforma. Para obtener una lista de las versiones admitidas, vea Requisitos del sistema.

.NET Framework

Compatible con: 2.0, 1.1, 1.0

.NET Compact Framework

Compatible con: 2.0
Contenido de la comunidad   ¿Qué es Community Content?
Agregar contenido nuevo RSS  Anotaciones
Processing
© 2012 Microsoft. Reservados todos los derechos. Términos de uso | Marcas Registradas | Privacidad
Page view tracker