GCHandle::Alloc Method (Object^, GCHandleType)
.NET Framework (current version)
Allocates a handle of the specified type for the specified object.
Assembly: mscorlib (in mscorlib.dll)
public: [SecurityCriticalAttribute] static GCHandle Alloc( Object^ value, GCHandleType type )
Parameters
- value
-
Type:
System::Object^
The object that uses the GCHandle.
- type
-
Type:
System.Runtime.InteropServices::GCHandleType
One of the GCHandleType values, indicating the type of GCHandle to create.
Return Value
Type: System.Runtime.InteropServices::GCHandleA new GCHandle of the specified type. This GCHandle must be released with Free when it is no longer needed.
| Exception | Condition |
|---|---|
| ArgumentException | An instance with nonprimitive (non-blittable) members cannot be pinned. |
SecurityCriticalAttribute
requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.
Universal Windows Platform
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Available since 8
.NET Framework
Available since 1.1
Portable Class Library
Supported in: portable .NET platforms
Silverlight
Available since 2.0
Windows Phone Silverlight
Available since 7.0
Windows Phone
Available since 8.1
Show: