Marshal.Release(IntPtr) Methode

Definition

Namespace:

System.Runtime.InteropServices

Assemblys:

netstandard.dll, System.Runtime.InteropServices.dll

Quelle:

Marshal.cs

Dekrementiert den Verweiszähler für die angegebene Schnittstelle.

C#

public static int Release(IntPtr pUnk);

Parameter

pUnk

IntPtr

Die freizugebende Schnittstelle.

Gibt zurück

Int32

Der neue Wert des Verweiszählers für die Schnittstelle, die durch den pUnk-Parameter angegeben ist.

Beispiele

Im folgenden Beispiel wird veranschaulicht, wie eine IUnknown Schnittstelle für ein verwaltetes Objekt mithilfe der GetIUnknownForObject -Methode abgerufen wird. Das Beispiel gibt dann den Schnittstellenzeiger durch Aufrufen der Release -Methode frei.

C#

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();
    }
}

Hinweise

Die Common Language Runtime verwaltet die Verweisanzahl eines COM-Objekts für Sie, sodass es nicht erforderlich ist, diese Methode direkt zu verwenden. Verwenden Sie diesen Wert nur zu Testzwecken. In seltenen Fällen, z. B. beim Testen eines benutzerdefinierten Marshallers, ist es möglicherweise erforderlich, die Lebensdauer eines Objekts manuell zu bearbeiten. Nur Programme, die aufrufen Marshal.AddRef , sollten aufrufen Release. Das Aufrufen Release , nachdem die Verweisanzahl 0 (null) erreicht wurde, führt zu undefiniertem Verhalten.

Sie können , Marshal.GetIUnknownForObjectoder Marshal.GetIDispatchForObject aufrufenMarshal.GetComInterfaceForObject, um einen IntPtr Wert abzurufen, der einen IUnknown-Schnittstellenzeiger für die Freigabe darstellt. Sie können diese Methoden und die Release -Methode auch für verwaltete Objekte verwenden, um die COM-Schnittstellen freizugeben, die durch den COM Callable Wrapper des verwalteten Objekts dargestellt werden.

Gilt für:

Weitere Informationen

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