GCHandle, structure

La classe GCHandle est utilisée avec l'énumération GCHandleType pour créer un handle correspondant à n'importe quel objet managé. Il existe quatre types possibles pour ce handle : Weak, WeakTrackResurrection, Normal ou Pinned. Lorsque le handle a été affecté, vous pouvez l'utiliser pour empêcher l'objet managé d'être récupéré par le garbage collector lorsqu'un client non managé détient la seule référence. Sans un tel handle, l'objet peut être récupéré par le garbage collector avant d'avoir terminé l'action qu'il est en train d'accomplir pour le client non managé.

Vous pouvez également utiliser GCHandle pour créer un objet épinglé qui retourne une adresse mémoire et empêche le garbage collector de placer l'objet en mémoire.

Lorsque le handle est hors de portée, vous devez le libérer explicitement en appelant la méthode Free ; sinon, des fuites de mémoire peuvent se produire. Lorsque vous libérez un handle épinglé, l'objet associé est désépinglé et devient disponible pour le garbage collection s'il n'y a pas d'autres références à celui-ci.

Dans l'exemple suivant, une classe App crée un handle vers un objet managé à l'aide de la méthode GCHandle.Alloc, évitant ainsi à l'objet managé d'être collecté. Un appel à la méthode EnumWindows permet de passer un délégué et un objet managé (tous deux déclarés comme types managés, mais non affichés) et d'effectuer un cast du handle en type IntPtr. La fonction non managée repasse le type à l'appelant sous la forme d'un paramètre de la fonction de rappel.

using System;
using System.IO;
using System.Threading;
using System.Windows.Forms;
using System.Runtime.InteropServices;
using System.Security.Permissions;

public delegate bool CallBack(int handle, IntPtr param);

public class LibWrap
{
	// passing managed object as LPARAM
	// BOOL EnumWindows(WNDENUMPROC lpEnumFunc, LPARAM lParam);

	[DllImport("user32.dll")]
	public static extern bool EnumWindows(CallBack cb, IntPtr param);
}

public class App
{
	public static void Main()
	{
		Run();
	}

        [SecurityPermission(SecurityAction.Demand, UnmanagedCode=true)]
	public static void Run()
        {
		TextWriter tw = System.Console.Out;
		GCHandle gch = GCHandle.Alloc(tw);

		CallBack cewp = new CallBack(CaptureEnumWindowsProc);

		// platform invoke will prevent delegate to be garbage collected
		// before call ends

		LibWrap.EnumWindows(cewp, GCHandle.ToIntPtr(gch));
		gch.Free();
        }

	private static bool CaptureEnumWindowsProc(int handle, IntPtr param)
	{
		GCHandle gch = GCHandle.FromIntPtr(param);
		TextWriter tw = (TextWriter)gch.Target;
		tw.WriteLine(handle);
		return true;
	}
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 ou ultérieur, Windows XP SP3, Windows XP SP2 Édition x64, Windows Server 2008 (installation minimale non prise en charge), Windows Server 2008 R2 (installation minimale prise en charge avec SP1 ou version ultérieure), Windows Server 2003 SP2

Référence

Autres ressources