Marshal.AddRef(IntPtr) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Incrementa a contagem de referências na interface especificada.
public:
static int AddRef(IntPtr pUnk);[System.Security.SecurityCritical]
public static int AddRef(IntPtr pUnk);public static int AddRef(IntPtr pUnk);[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int AddRef(IntPtr pUnk);[<System.Security.SecurityCritical>]
static member AddRef : nativeint -> intstatic member AddRef : nativeint -> int[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member AddRef : nativeint -> intPublic Shared Function AddRef (pUnk As IntPtr) As IntegerParâmetros
- pUnk
-
IntPtr
nativeint
A contagem de referências da interface para incrementar.
Devoluções
O novo valor da contagem de referência no pUnk parâmetro.
- Atributos
Observações
O runtime da linguagem comum gere a contagem de referências de um objeto COM por si, tornando desnecessário usar este método diretamente. Em casos raros, como ao testar um marshaler personalizado, pode ser necessário manipular manualmente a vida útil de um objeto. Depois de chamar AddRef, deve decrementar a contagem de referências usando um método como Marshal.Release. Não confie no valor de retorno de AddRef, pois por vezes pode ser instável.
Pode chamar Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject, ou Marshal.GetIDispatchForObject obter um IntPtr valor que represente um ponteiro de interface IUnknown . Também pode usar estes métodos e o AddRef método em objetos geridos para obter as interfaces COM representadas pelo wrapper COM chamável do objeto gerido. Se não estiver familiarizado com os detalhes deste tipo de wrapper, veja COM Callable Wrapper.
