Marshal.Release(IntPtr) Método

Definição

Namespace:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origem:

Marshal.cs

Diminui a contagem de referência na interface especificada.

public:
 static int Release(IntPtr pUnk);

public static int Release (IntPtr pUnk);

static member Release : nativeint -> int

Public Shared Function Release (pUnk As IntPtr) As Integer

Parâmetros

pUnk

IntPtr

nativeint

A interface a ser liberada.

Retornos

Int32

O novo valor da contagem de referência na interface especificada pelo parâmetro pUnk.

Exemplos

O exemplo a seguir demonstra como recuperar uma IUnknown interface para um objeto gerenciado usando o GetIUnknownForObject método . Em seguida, o exemplo libera o ponteiro da interface chamando o Release método .

using System;
using System.Runtime.InteropServices;

class Program
{

    static void Run()
    {

        // Create an int object
        int obj = 1;

        Console.WriteLine("Calling Marshal.GetIUnknownForObject...");

        // Get the IUnKnown pointer for the Integer object
        IntPtr pointer = Marshal.GetIUnknownForObject(obj);

        Console.WriteLine("Calling Marshal.Release...");

        // Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer);
    }

    static void Main(string[] args)
    {
        Run();
    }
}

Imports System.Runtime.InteropServices

Module Program


    Sub Run()

        ' Dim an Integer object
        Dim IntegerObject As Integer = 1

        ' Dim a pointer
        Dim pointer As IntPtr

        Console.WriteLine("Calling Marshal.GetIUnknownForObject...")

        ' Get the IUnKnown pointer for the Integer object
        pointer = Marshal.GetIUnknownForObject(IntegerObject)

        Console.WriteLine("Calling Marshal.Release...")

        ' Always call Marshal.Release to decrement the reference count.
        Marshal.Release(pointer)



    End Sub

    Sub Main(ByVal args() As String)

        Run()

    End Sub

End Module

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. Use esse valor apenas para fins de teste. Em casos raros, como testar um marshaler personalizado, você pode achar necessário manipular o tempo de vida de um objeto manualmente. Somente os programas que chamam Marshal.AddRef devem chamar Release. Chamar Release depois que a contagem de referência atingiu zero causa um comportamento indefinido.

Você pode chamar Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjectou Marshal.GetIDispatchForObject para obter um IntPtr valor que representa um ponteiro de interface IUnknown para liberação. Você também pode usar esses métodos e o Release método em objetos gerenciados para liberar as interfaces COM representadas pelo Wrapper Callable COM do objeto gerenciado.

Confira também

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