Marshal.AddRef(IntPtr) Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

Marshal.cs

Incrementa a contagem de referência na interface 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

A contagem de referência da interface a ser incrementada.

Retornos

Int32

O novo valor da contagem de referência no parâmetro pUnk.

Comentários

O Common Language Runtime gerencia a contagem de referência de um objeto COM para você, tornando desnecessário usar esse método diretamente. Em casos raros, como testar um marshaler personalizado, você pode achar necessário manipular o tempo de vida de um objeto manualmente. Depois de chamar AddRef, você deve diminuir a contagem de referência usando um método como Marshal.Release. Não dependa do valor retornado de AddRef, pois às vezes pode ser instável.

Você pode chamar Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject para obter um IntPtr valor que representa um ponteiro de interface IUnknown . Você também pode usar esses métodos e o AddRef método em objetos gerenciados para obter as interfaces COM representadas pelo wrapper callable COM do objeto gerenciado. Se você não estiver familiarizado com os detalhes desse tipo de wrapper, consulte COM Callable Wrapper.

Confira também

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