Marshal.ReAllocHGlobal-Methode

Ändert die Größe eines bereits mit AllocHGlobal reservierten Speicherblocks.

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

Syntax

'Declaration
Public Shared Function ReAllocHGlobal ( _
    pv As IntPtr, _
    cb As IntPtr _
) As IntPtr
'Usage
Dim pv As IntPtr
Dim cb As IntPtr
Dim returnValue As IntPtr

returnValue = Marshal.ReAllocHGlobal(pv, cb)

public static IntPtr ReAllocHGlobal (
    IntPtr pv,
    IntPtr cb
)

public:
static IntPtr ReAllocHGlobal (
    IntPtr pv, 
    IntPtr cb
)

public static IntPtr ReAllocHGlobal (
    IntPtr pv, 
    IntPtr cb
)

public static function ReAllocHGlobal (
    pv : IntPtr, 
    cb : IntPtr
) : IntPtr

Parameter

• pv
  Ein Zeiger auf den mit AllocHGlobal reservierten Speicher.

• cb
  Die neue Größe des reservierten Blocks.

Rückgabewert

Ein IntPtr auf den erneut reservierten Speicher. Dieser Speicher muss mit Marshal.FreeHGlobal freigegeben werden.

Ausnahmen

Ausnahmetyp	Bedingung
OutOfMemoryException	Es ist nicht genügend Speicherplatz vorhanden, um die Anforderung zu erfüllen.

Hinweise

ReAllocHGlobal ist eine der beiden API-Methoden für die Speicherreservierung in der Marshal-Klasse. (Die andere ist Marshal.ReAllocCoTaskMem.) Diese Methode macht die GlobalRealloc-Win32-API-Methode aus Kernel32.dll verfügbar. Der zurückgegebene Zeiger kann vom ursprünglichen abweichen. Weitere Informationen zu GlobalAlloc finden Sie in der MSDN Library.

Hinweis

Diese Methode verwendet SecurityAction.LinkDemand, um einen Aufruf aus nicht vertrauenswürdigem Code zu verhindern. Nur der direkte Aufrufer muss über die SecurityPermissionAttribute.UnmanagedCode-Berechtigung verfügen. Wenn der Code aus teilweise vertrauenswürdigem Code aufgerufen werden kann, dürfen Benutzereingaben nicht ohne Validierung an Methoden der Marshal-Klasse übergeben werden. Wichtige Einschränkungen bei der Verwendung des LinkDemand-Members finden Sie unter "Demand" und "LinkDemand".

.NET Framework-Sicherheit

• SecurityPermission  für die Berechtigung zum Aufrufen von nicht verwaltetem Code. Zugeordnete Enumeration: UnmanagedCode Sicherheitsaktion: LinkDemand

Plattformen

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

.NET Compact Framework

Unterstützt in: 2.0

Siehe auch

Referenz

Marshal-Klasse
Marshal-Member
System.Runtime.InteropServices-Namespace
ReAllocCoTaskMem
FreeHGlobal