Marshal.Release(IntPtr) Method

Reference

Definition

Namespace:: System.Runtime.InteropServices

Assemblies:: mscorlib.dll, System.Runtime.InteropServices.dll

Assemblies:: netstandard.dll, System.Runtime.InteropServices.dll

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Marshal.cs

Source:: Marshal.cs

Source:: Marshal.cs

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Decrements the reference count on the specified interface.

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

Parameters

pUnk: IntPtr

The interface to release.

Returns

Int32

The new value of the reference count on the interface specified by the pUnk parameter.

Attributes: SecurityCriticalAttribute SupportedOSPlatformAttribute

Examples

The following example demonstrates how to retrieve an IUnknown interface for a managed object using the GetIUnknownForObject method. The example then releases the interface pointer by calling the Release method.

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

Remarks

The common language runtime manages the reference count of a COM object for you, making it unnecessary to use this method directly. Use this value only for testing purposes. In rare cases, such as testing a custom marshaler, you might find it necessary to manipulate an object's lifetime manually. Only programs that call Marshal.AddRef should call Release. Calling Release after the reference count has reached zero causes undefined behavior.

You can call Marshal.GetComInterfaceForObject, Marshal.GetIUnknownForObject, or Marshal.GetIDispatchForObject to obtain an IntPtr value that represents a IUnknown interface pointer to release. You can also use these methods and the Release method on managed objects to release the COM interfaces represented by the managed object's COM Callable Wrapper.

Applies to

Product	Versions
.NET	Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9
.NET Framework	1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard	1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1
UWP	10.0

Share via