Marshal.AllocHGlobal Méthode
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.
Alloue de la mémoire non managée du processus.
| AllocHGlobal(Int32) |
Alloue de la mémoire non managée du processus à l’aide du nombre spécifié d’octets. |
| AllocHGlobal(IntPtr) |
Alloue de la mémoire non managée du processus en utilisant le pointeur vers le nombre spécifié d’octets. |
- Source:
- Marshal.cs
- Source:
- Marshal.cs
- Source:
- Marshal.cs
Alloue de la mémoire non managée du processus à l’aide du nombre spécifié d’octets.
public:
static IntPtr AllocHGlobal(int cb);[System.Security.SecurityCritical]
public static IntPtr AllocHGlobal(int cb);public static IntPtr AllocHGlobal(int cb);[<System.Security.SecurityCritical>]
static member AllocHGlobal : int -> nativeintstatic member AllocHGlobal : int -> nativeintPublic Shared Function AllocHGlobal (cb As Integer) As IntPtrParamètres
- cb
- Int32
Nombre requis d’octets en mémoire.
Retours
nativeint
Pointeur vers la mémoire nouvellement allouée. Cette mémoire doit être libérée à l’aide de la méthode FreeHGlobal(IntPtr).
- Attributs
Exceptions
La mémoire est insuffisante pour répondre à la demande.
Exemples
L’exemple suivant illustre l’appel de la méthode AllocHGlobal. Cet exemple de code fait partie d’un exemple plus large fourni pour la classe Marshal.
// Demonstrate how to call GlobalAlloc and
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal::AllocHGlobal(100);
Marshal::FreeHGlobal(hglobal);
// Demonstrate how to call GlobalAlloc and
// GlobalFree using the Marshal class.
IntPtr hglobal = Marshal.AllocHGlobal(100);
Marshal.FreeHGlobal(hglobal);
' Demonstrate how to call GlobalAlloc and
' GlobalFree using the Marshal class.
Dim hglobal As IntPtr = Marshal.AllocHGlobal(100)
Marshal.FreeHGlobal(hglobal)
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.
AllocHGlobal est l’une des deux méthodes d’allocation de mémoire dans la classe Marshal. (
Lorsque AllocHGlobal appelle LocalAlloc, il transmet un indicateur de LMEM_FIXED, ce qui entraîne le verrouillage de la mémoire allouée. En outre, la mémoire allouée n’est pas remplie à zéro.
Voir aussi
S’applique à
.NET 10 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
- Source:
- Marshal.Unix.cs
- Source:
- Marshal.Unix.cs
- Source:
- Marshal.Unix.cs
Alloue de la mémoire non managée du processus en utilisant le pointeur vers le nombre spécifié d’octets.
public:
static IntPtr AllocHGlobal(IntPtr cb);[System.Security.SecurityCritical]
public static IntPtr AllocHGlobal(IntPtr cb);public static IntPtr AllocHGlobal(IntPtr cb);[<System.Security.SecurityCritical>]
static member AllocHGlobal : nativeint -> nativeintstatic member AllocHGlobal : nativeint -> nativeintPublic Shared Function AllocHGlobal (cb As IntPtr) As IntPtrParamètres
- cb
-
IntPtr
nativeint
Nombre requis d’octets en mémoire.
Retours
nativeint
Pointeur vers la mémoire nouvellement allouée. Cette mémoire doit être libérée à l’aide de la méthode FreeHGlobal(IntPtr).
- Attributs
Exceptions
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.
AllocHGlobal est l’une des deux méthodes d’allocation de mémoire dans la classe Marshal. (
Lorsque AllocHGlobal appelle LocalAlloc, il transmet un indicateur de LMEM_FIXED, ce qui entraîne le verrouillage de la mémoire allouée. En outre, la mémoire allouée n’est pas remplie à zéro.
Pour obtenir un exemple de code, consultez Marshal et AllocHGlobal.
Voir aussi
S’applique à
.NET 10 et autres versions
| Produit | Versions |
|---|---|
| .NET | Core 1.0, Core 1.1, Core 2.0, Core 2.1, Core 2.2, Core 3.0, Core 3.1, 5, 6, 7, 8, 9, 10 |
| .NET Framework | 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1 |
| .NET Standard | 1.1, 1.2, 1.3, 1.4, 1.5, 1.6, 2.0, 2.1 |
| UWP | 10.0 |
Commentaires sur .NET
.NET est un projet open source. Sélectionnez un lien pour fournir des commentaires :