Marshal.Release(IntPtr) Methode

Referenz

Definition

Namespace:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Quelle:: Marshal.cs

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

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

public:
 static int Release(IntPtr pUnk);

[System.Security.SecurityCritical]
public static int Release (IntPtr pUnk);

[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static int Release (IntPtr pUnk);

public static int Release (IntPtr pUnk);

[<System.Security.SecurityCritical>]
static member Release : nativeint -> int

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member Release : nativeint -> int

static member Release : nativeint -> int

Public Shared Function Release (pUnk As IntPtr) As Integer

Parameter

pUnk: IntPtr
nativeint

Die freizugebende Schnittstelle.

Gibt zurück

Int32

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

Attribute: SecurityCriticalAttribute SupportedOSPlatformAttribute

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.

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

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 ändern. Nur Programme, die aufrufen Marshal.AddRef , sollten aufrufen Release. Das Aufrufen Release , nachdem die Verweisanzahl null erreicht hat, verursacht nicht definiertes Verhalten.

Sie können , Marshal.GetIUnknownForObjectoder Marshal.GetIDispatchForObject aufrufenMarshal.GetComInterfaceForObject, um einen IntPtr Wert abzurufen, der einen zu freigebenden IUnknown-Schnittstellenzeiger 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: