Marshal.ReAllocHGlobal Method
Resizes a block of memory previously allocated with AllocHGlobal.
Namespace: System.Runtime.InteropServices
Assembly: mscorlib (in mscorlib.dll)
Parameters
- pv
- Type: System.IntPtr
A pointer to memory allocated with AllocHGlobal.
- cb
- Type: System.IntPtr
The new size of the allocated block. This is not a pointer; it is the byte count you are requesting, cast to type IntPtr. If you pass a pointer, it is treated as a size.
Return Value
Type: System.IntPtrA pointer to the reallocated memory. This memory must be released using Marshal.FreeHGlobal.
| Exception | Condition |
|---|---|
| OutOfMemoryException | There is insufficient memory to satisfy the request. |
ReAllocHGlobal is one of two memory reallocation API methods in the Marshal class. (Marshal.ReAllocCoTaskMem is the other.)
This method exposes the Win32 GlobalReAlloc function from Kernel32.dll. The returned pointer can differ from the original. If it is different, the contents of the original memory block have been copied to the new block, and the original memory block has been freed.
- SecurityCriticalAttribute
requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
