GCHandle Structure

This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.

[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]

Provides a means for accessing a managed object from unmanaged memory.

Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)

Syntax

No code example is currently available or this language may not be supported.

The GCHandle type exposes the following members.

	Name	Description
	IsAllocated	Gets a value indicating whether the handle is allocated.
	Target	Gets or sets the object this handle represents.

	Name	Description
	AddrOfPinnedObject	Security Critical. Retrieves the address of an object in a Pinned handle.
	Alloc(Object)	Security Critical. Allocates a Normal handle for the specified object.
	Alloc(Object, GCHandleType)	Security Critical. Allocates a handle of the specified type for the specified object.
	Equals	Determines whether the specified GCHandle object is equal to the current GCHandle object. (Overrides ValueType::Equals(Object).)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before the Object is reclaimed by garbage collection. (Inherited from Object.)
	Free	Security Critical. Releases a GCHandle.
	FromIntPtr	Security Critical. Returns a new GCHandle object created from a handle to a managed object.
	GetHashCode	Returns an identifier for the current GCHandle object. (Overrides ValueType::GetHashCode().)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToIntPtr	Returns the internal integer representation of a GCHandle object.
	ToString	Returns the fully qualified type name of this instance. (Inherited from ValueType.)

	Name	Description
	Explicit(GCHandle to IntPtr)	A GCHandle is stored using an internal integer representation.
	Explicit(IntPtr to GCHandle)	Security Critical. A GCHandle is stored using an internal integer representation.