Marshal.ReAllocHGlobal(IntPtr, IntPtr) Méthode

Référence

Définition

Espace de noms:: System.Runtime.InteropServices

Assembly:: System.Runtime.InteropServices.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Source:: Marshal.Unix.cs

Source:: Marshal.Unix.cs

Source:: Marshal.Unix.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Redimensionne un bloc de mémoire précédemment alloué avec 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 -> nativeint

static member ReAllocHGlobal : nativeint * nativeint -> nativeint

Public Shared Function ReAllocHGlobal (pv As IntPtr, cb As IntPtr) As IntPtr

Paramètres

pv: IntPtr
nativeint

Pointeur vers la mémoire allouée avec AllocHGlobal(IntPtr).

cb: IntPtr
nativeint

Nouvelle taille du bloc alloué. Ce n’est pas un pointeur ; il s’agit du nombre d’octets que vous demandez, effectuez un cast pour taper IntPtr. Si vous passez un pointeur, il est traité comme une taille.

Retours

IntPtr

nativeint

Pointeur vers la mémoire réaffectée. Cette mémoire doit être libérée à l’aide de FreeHGlobal(IntPtr).

Attributs: SecurityCriticalAttribute

Exceptions

OutOfMemoryException

La mémoire est insuffisante pour répondre à la demande.

Remarques

Important

Cet allocateur de mémoire native est une API héritée qui doit être utilisée exclusivement lorsqu’elle est appelée par des API Win32 spécifiques sur la plateforme Windows. Lorsque vous ciblez .NET 6 ou version ultérieure, utilisez la classe NativeMemory sur toutes les plateformes pour allouer de la mémoire native. Lorsque vous ciblez .NET 6 ou une version antérieure, utilisez AllocCoTaskMem sur toutes les plateformes pour allouer de la mémoire native.

ReAllocHGlobal est l’une des deux méthodes de l’API de réaffectation de mémoire dans la classe Marshal. (Marshal.ReAllocCoTaskMem est l’autre.)

Cette méthode expose la fonction de GlobalReAlloc win32 de Kernel32.dll. Le pointeur retourné peut différer de l’original. S’il est différent, le contenu du bloc de mémoire d’origine a été copié dans le nouveau bloc et le bloc de mémoire d’origine a été libéré.

S’applique à

Partager via