Marshal.FreeHGlobal(IntPtr) Metodo

public:
 static void FreeHGlobal(IntPtr hglobal);

[System.Security.SecurityCritical]
public static void FreeHGlobal (IntPtr hglobal);

public static void FreeHGlobal (IntPtr hglobal);

[<System.Security.SecurityCritical>]
static member FreeHGlobal : nativeint -> unit

static member FreeHGlobal : nativeint -> unit

Public Shared Sub FreeHGlobal (hglobal As IntPtr)

Parametri

Attributi

SecurityCriticalAttribute

Esempio

Nel codice riportato di seguito viene illustrata la chiamata al metodo FreeHGlobal. Questo esempio di codice fa parte di un esempio più ampio fornito per la Marshal classe .

// Demonstrate how to call GlobalAlloc and 
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal::AllocHGlobal(100);
Marshal::FreeHGlobal(hglobal);

// Demonstrate how to call GlobalAlloc and
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal.AllocHGlobal(100);
Marshal.FreeHGlobal(hglobal);

' Demonstrate how to call GlobalAlloc and 
' GlobalFree using the Marshal class.
Dim hglobal As IntPtr = Marshal.AllocHGlobal(100)
Marshal.FreeHGlobal(hglobal)

Nell'esempio seguente viene illustrato come convertire il contenuto di una classe gestita in memoria non gestita e quindi eliminare la memoria non gestita String al termine.

using namespace System;
using namespace System::Runtime::InteropServices;

#include <iostream>                                                 // for printf


int main()
{
    // Create a managed string.
    String^ managedString = "Hello unmanaged world (from the managed world).";

    // Marshal the managed string to unmanaged memory.
    char* stringPointer = (char*) Marshal::StringToHGlobalAnsi(managedString ).ToPointer();

    printf("stringPointer = %s\n", stringPointer);

    // Always free the unmanaged string.
    Marshal::FreeHGlobal(IntPtr(stringPointer));

    return 0;
}

using System;
using System.Runtime.InteropServices;
using System.Threading;

class MainFunction
{
    static void Main()
    {
        Console.WriteLine("\nStringToGlobalAnsi\n");

        // Create a managed string.
        String  managedString = "I am a managed String";
        Console.WriteLine("1) managedString = " + managedString);

        // Marshal the managed string to unmanaged memory.
        IntPtr stringPointer = (IntPtr)Marshal.StringToHGlobalAnsi(managedString);
        Console.WriteLine("2) stringPointer = {0}", stringPointer);

        // Get the string back from unmanaged memory.
        String RetrievedString = Marshal.PtrToStringAnsi(stringPointer);
        Console.WriteLine("3) Retrieved from unmanaged memory = " + RetrievedString);

        // Always free the unmanaged string.
        Marshal.FreeHGlobal(stringPointer);

        // IntPtr handle value is still the same:
        Console.WriteLine("4) stringPointer = " + stringPointer);

        // However, the data may be cleared after the memory is freed, depending on whether the memory allocated to stringPointer
        // has been reclaimed or not. Uncommenting the following line (Thread.Sleep(1000)) increases the likelihood of the memory being reclaimed.
        // Thread.Sleep(1000);
        String RetrievedString2 = Marshal.PtrToStringAnsi(stringPointer);
        Console.WriteLine("5) RetrievedString2 = " + RetrievedString2);
    }
}

Commenti

È possibile usare FreeHGlobal per liberare memoria dall'heap globale allocato da AllocHGlobal, ReAllocHGlobalo qualsiasi metodo API non gestito equivalente. Se il hglobal parametro è IntPtr.Zero il metodo non esegue alcuna operazione.

FreeHGlobal espone la funzione LocalFree da Kernel32.DLL, che libera tutti i byte in modo che non sia più possibile usare la memoria a hglobalcui punta .

Oltre a FreeHGlobal, la Marshal classe fornisce altri due metodi api di deallocazione della memoria: DestroyStructure e FreeCoTaskMem.

Si applica a

Vedi anche

• AllocHGlobal(IntPtr)
• ReAllocHGlobal(IntPtr, IntPtr)