Marshal.AddRef(IntPtr) Método

Definição

Incrementa a contagem de referência na interface especificada.Increments the reference count on the specified interface.

public:
 static int AddRef(IntPtr pUnk);
[System.Security.SecurityCritical]
public static int AddRef (IntPtr pUnk);
static member AddRef : nativeint -> int
Public Shared Function AddRef (pUnk As IntPtr) As Integer

Parâmetros

pUnk
IntPtr

A contagem de referência da interface a ser incrementada.The interface reference count to increment.

Retornos

O novo valor da contagem de referência no parâmetro pUnk.The new value of the reference count on the pUnk parameter.

Atributos

Comentários

O Common Language Runtime gerencia a contagem de referência de um objeto COM para você, tornando-o desnecessário usar esse método diretamente.The common language runtime manages the reference count of a COM object for you, making it unnecessary to use this method directly. Em casos raros, como testar um marshaler personalizado, talvez você ache necessário manipular o tempo de vida de um objeto manualmente.In rare cases, such as testing a custom marshaler, you might find it necessary to manipulate an object's lifetime manually. Depois de chamar AddRef, você deve decrementar a contagem de referência usando um método como Marshal.Release.After calling AddRef, you must decrement the reference count by using a method such as Marshal.Release. Não confie no valor de retorno de AddRef, pois às vezes pode ser instável.Do not rely on the return value of AddRef, as it can sometimes be unstable.

Você pode chamar Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject para obter um valor de IntPtr que representa um ponteiro de interface IUnknown .You can call Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject, or Marshal.GetIDispatchForObject to obtain an IntPtr value that represents an IUnknown interface pointer. Você também pode usar esses métodos e o método AddRef em objetos gerenciados para obter as interfaces COM representadas pelo COM Callable Wrapper do objeto gerenciado.You can also use these methods and the AddRef method on managed objects to obtain the COM interfaces represented by the managed object's COM callable wrapper. Se você não estiver familiarizado com os detalhes desse tipo de wrapper, consulte com callable wrapper com.If you are not familiar with the details of this wrapper type, see COM Callable Wrapper.

Segurança

SecurityCriticalAttribute
requer confiança total para o chamador imediato.requires full trust for the immediate caller. Este membro não pode ser usado pelo código transparente ou parcialmente confiável.This member cannot be used by partially trusted or transparent code.

Aplica-se a

Veja também