Marshal.AllocHGlobal Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Belegt Speicher aus dem nicht verwalteten Speicher des Prozesses.
Überlädt
| AllocHGlobal(Int32) |
Reserviert Speicher aus dem nicht verwalteten Arbeitsspeicher des Prozesses mit der angegebenen Anzahl von Bytes. |
| AllocHGlobal(IntPtr) |
Reserviert Speicher aus dem nicht verwalteten Arbeitsspeicher des Prozesses mithilfe des Zeigers auf die angegebene Anzahl von Bytes. |
AllocHGlobal(Int32)
Reserviert Speicher aus dem nicht verwalteten Arbeitsspeicher des Prozesses mit der angegebenen Anzahl von Bytes.
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 IntPtrParameter
- cb
- Int32
Die erforderliche Anzahl der Bytes im Speicher.
Gibt zurück
-
IntPtr
nativeint
Ein Zeiger auf den neu reservierten Speicher. Dieser Speicher muss unter Verwendung der FreeHGlobal(IntPtr)-Methode freigegeben werden.
- Attribute
Ausnahmen
Es ist nicht genügend Arbeitsspeicher zum Erfüllen der Anforderung vorhanden.
Beispiele
Im folgenden Beispiel wird das Aufrufen der AllocHGlobal-Methode veranschaulicht. Dieses Codebeispiel ist Teil eines größeren Beispiels, das für die Marshal-Klasse bereitgestellt wird.
// 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)
Hinweise
AllocHGlobal ist eine von zwei Speicherzuweisungsmethoden in der Marshal Klasse. (Marshal.AllocCoTaskMem ist der andere.) Diese Methode macht die Funktion Win32 LocalAlloc aus Kernel32.dll verfügbar.
Bei AllocHGlobal Aufrufen LocalAllocübergibt es ein LMEM_FIXED Flag, wodurch der zugewiesene Arbeitsspeicher gesperrt wird. Außerdem ist der zugewiesene Speicher nicht null gefüllt.
Siehe auch
Gilt für
AllocHGlobal(IntPtr)
Reserviert Speicher aus dem nicht verwalteten Arbeitsspeicher des Prozesses mithilfe des Zeigers auf die angegebene Anzahl von Bytes.
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 IntPtrParameter
- cb
-
IntPtr
nativeint
Die erforderliche Anzahl der Bytes im Speicher.
Gibt zurück
-
IntPtr
nativeint
Ein Zeiger auf den neu reservierten Speicher. Dieser Speicher muss unter Verwendung der FreeHGlobal(IntPtr)-Methode freigegeben werden.
- Attribute
Ausnahmen
Es ist nicht genügend Arbeitsspeicher zum Erfüllen der Anforderung vorhanden.
Hinweise
AllocHGlobal ist eine von zwei Speicherzuweisungsmethoden in der Marshal Klasse. (Marshal.AllocCoTaskMem ist der andere.) Diese Methode macht die Funktion Win32 LocalAlloc aus Kernel32.dll verfügbar.
Bei AllocHGlobal Aufrufen LocalAllocübergibt es ein LMEM_FIXED Flag, wodurch der zugewiesene Arbeitsspeicher gesperrt wird. Außerdem ist der zugewiesene Speicher nicht null gefüllt.
Beispielcode, siehe Marshal und AllocHGlobal.