Marshal.ReAllocHGlobal(IntPtr, IntPtr) Methode
Definitie
Belangrijk
Bepaalde informatie heeft betrekking op een voorlopige productversie die aanzienlijk kan worden gewijzigd voordat deze wordt uitgebracht. Microsoft biedt geen enkele expliciete of impliciete garanties met betrekking tot de informatie die hier wordt verstrekt.
Hiermee wijzigt u het formaat van een blok geheugen dat eerder is toegewezen met AllocHGlobal(IntPtr).
public:
static IntPtr ReAllocHGlobal(IntPtr pv, IntPtr cb);[System.Security.SecurityCritical]
public static IntPtr ReAllocHGlobal(IntPtr pv, IntPtr cb);public static IntPtr ReAllocHGlobal(IntPtr pv, IntPtr cb);[<System.Security.SecurityCritical>]
static member ReAllocHGlobal : nativeint * nativeint -> nativeintstatic member ReAllocHGlobal : nativeint * nativeint -> nativeintPublic Shared Function ReAllocHGlobal (pv As IntPtr, cb As IntPtr) As IntPtrParameters
- pv
-
IntPtr
nativeint
Een aanwijzer naar geheugen toegewezen met AllocHGlobal(IntPtr).
- cb
-
IntPtr
nativeint
De nieuwe grootte van het toegewezen blok. Dit is geen aanwijzer; het is het byteaantal dat u aanvraagt, cast om te typen IntPtr. Als u een aanwijzer doorgeeft, wordt deze behandeld als een grootte.
Retouren
nativeint
Een aanwijzer naar het opnieuw toegewezen geheugen. Dit geheugen moet worden vrijgegeven met behulp van FreeHGlobal(IntPtr).
- Kenmerken
Uitzonderingen
Er is onvoldoende geheugen om aan de aanvraag te voldoen.
Opmerkingen
Important
Deze systeemeigen geheugentoewijzing is een verouderde API die uitsluitend moet worden gebruikt wanneer deze wordt aangeroepen door specifieke Win32-API's op het Windows-platform. Wanneer u zich richt op .NET 6 of hoger, gebruikt u de klasse NativeMemory op alle platforms om systeemeigen geheugen toe te wijzen. Wanneer u zich richt op .NET Framework, gebruikt u AllocCoTaskMem op alle platforms om systeemeigen geheugen toe te wijzen.
ReAllocHGlobal is een van de twee methoden voor het opnieuw toewijzen van geheugen in de Marshal klasse. (Marshal.ReAllocCoTaskMem is de andere.)
Met deze methode wordt de functie Win32 GlobalReAlloc van Kernel32.dllweergegeven. De geretourneerde aanwijzer kan afwijken van het origineel. Als het anders is, is de inhoud van het oorspronkelijke geheugenblok gekopieerd naar het nieuwe blok en is het oorspronkelijke geheugenblok vrijgemaakt.
