Marshal.Release(IntPtr) Metodo

Definizione

Spazio dei nomi:

System.Runtime.InteropServices

Assembly:

System.Runtime.InteropServices.dll

Origine:

Marshal.cs

Riduce il numero di riferimenti nell'interfaccia specificata.

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

Parametri

pUnk

IntPtr

nativeint

Interfaccia da liberare.

Restituisce

Int32

Nuovo valore del numero di riferimenti nell'interfaccia specificata dal parametro pUnk.

Esempio

Nell'esempio seguente viene illustrato come recuperare un'interfaccia IUnknown per un oggetto gestito usando il GetIUnknownForObject metodo . L'esempio rilascia quindi il puntatore dell'interfaccia chiamando il Release metodo .

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

Commenti

Common Language Runtime gestisce il conteggio dei riferimenti di un oggetto COM da usare direttamente. Usare questo valore solo per scopi di test. In rari casi, ad esempio il test di un marshalling personalizzato, potrebbe essere necessario modificare manualmente la durata di un oggetto. Solo i programmi che chiamano devono chiamare Marshal.AddRefRelease. La chiamata Release dopo che il conteggio dei riferimenti ha raggiunto zero causa un comportamento non definito.

È possibile chiamare Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObjecto Marshal.GetIDispatchForObject per ottenere un valore che rappresenta un IntPtr puntatore dell'interfaccia IUnknown da rilasciare. È anche possibile usare questi metodi e il Release metodo sugli oggetti gestiti per rilasciare le interfacce COM rappresentate dal wrapper COM dell'oggetto gestito.

Vedi anche

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