Marshal.AllocHGlobal Metoda

Definice

Obor názvů:

System.Runtime.InteropServices

Sestavení:

System.Runtime.InteropServices.dll

Přidělí paměť z nespravované paměti procesu.

Přetížení

AllocHGlobal(Int32)	Přidělí paměť z nespravované paměti procesu pomocí zadaného počtu bajtů.
AllocHGlobal(IntPtr)	Přidělí paměť z nespravované paměti procesu pomocí ukazatele na zadaný počet bajtů.

AllocHGlobal(Int32)

Zdroj:

Marshal.cs

Přidělí paměť z nespravované paměti procesu pomocí zadaného počtu bajtů.

public:
 static IntPtr AllocHGlobal(int cb);

public static IntPtr AllocHGlobal (int cb);

static member AllocHGlobal : int -> nativeint

Public Shared Function AllocHGlobal (cb As Integer) As IntPtr

Parametry

cb

Int32

Požadovaný počet bajtů v paměti.

Návraty

IntPtr

nativeint

Ukazatel na nově přidělenou paměť. Tato paměť musí být uvolněna FreeHGlobal(IntPtr) pomocí metody .

Výjimky

OutOfMemoryException

K uspokojení požadavku není dostatek paměti.

Příklady

Následující příklad ukazuje volání AllocHGlobal metody . Tento příklad kódu je součástí většího příkladu Marshal pro třídu .

// 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)

Poznámky

AllocHGlobal je jednou ze dvou metod přidělování paměti ve Marshal třídě . (Marshal.AllocCoTaskMem je druhý.) Tato metoda zveřejňuje funkci Win32 LocalAlloc z Kernel32.dll.

Při AllocHGlobal volání LocalAllocpředá LMEM_FIXED příznak, který způsobí, že přidělená paměť bude uzamčena na místě. Přidělená paměť také není vyplněná nulou.

Viz také

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)

AllocHGlobal(IntPtr)

Zdroj:

Marshal.Unix.cs

Přidělí paměť z nespravované paměti procesu pomocí ukazatele na zadaný počet bajtů.

public:
 static IntPtr AllocHGlobal(IntPtr cb);

public static IntPtr AllocHGlobal (IntPtr cb);

static member AllocHGlobal : nativeint -> nativeint

Public Shared Function AllocHGlobal (cb As IntPtr) As IntPtr

Parametry

cb

IntPtr

nativeint

Požadovaný počet bajtů v paměti.

Návraty

IntPtr

nativeint

Ukazatel na nově přidělenou paměť. Tato paměť musí být uvolněna FreeHGlobal(IntPtr) pomocí metody .

Výjimky

OutOfMemoryException

K uspokojení požadavku není dostatek paměti.

Poznámky

AllocHGlobal je jednou ze dvou metod přidělování paměti ve Marshal třídě . (Marshal.AllocCoTaskMem je druhý.) Tato metoda zveřejňuje funkci Win32 LocalAlloc z Kernel32.dll.

Při AllocHGlobal volání LocalAllocpředá LMEM_FIXED příznak, který způsobí, že přidělená paměť bude uzamčena na místě. Přidělená paměť také není vyplněná nulou.

Například kód najdete v tématech Marshal a AllocHGlobal.

Viz také

• AllocCoTaskMem(Int32)
• FreeHGlobal(IntPtr)