Marshal.AllocCoTaskMem-Methode: (Int32)

Artikel
04/20/2017

Veröffentlicht: Oktober 2016

Belegt einen Speicherblock der angegebenen Größe aus der Speicherbelegungsfunktion für COM-Aufgaben.

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

Syntax

[SecurityCriticalAttribute]
public static IntPtr AllocCoTaskMem(
    int cb
)

public:
[SecurityCriticalAttribute]
static IntPtr AllocCoTaskMem(
    int cb
)

[<SecurityCriticalAttribute>]
static member AllocCoTaskMem : 
        cb:int -> nativeint

<SecurityCriticalAttribute>
Public Shared Function AllocCoTaskMem (
    cb As Integer
) As IntPtr

Parameter

cb
Type: System.Int32

Die Größe des zu belegenden Speicherblocks.

Rückgabewert

Type: System.IntPtr

Eine ganze Zahl, die die Adresse des belegten Speicherblocks darstellt. Dieser Speicher muss mit Marshal.FreeCoTaskMem freigegeben werden.

Ausnahmen

Exception	Condition
OutOfMemoryException	Es ist nicht genügend Arbeitsspeicher zum Erfüllen der Anforderung vorhanden.

Hinweise

AllocCoTaskMem ist eine der beiden speicherbelegung API-Methoden in der Marshal Klasse. (Marshal.AllocHGlobal die andere ist.) Der erste zurückgegebene Speicherinhalt ist nicht definiert, und der belegte Arbeitsspeicher kann größer sein als die angeforderte Anzahl von Bytes. Diese Methode macht COM CoTaskMemAlloc -Funktion, die als der Speicherbelegungsfunktion für COM-Aufgaben bezeichnet wird.

Sicherheit

SecurityCriticalAttribute

requires full trust for the immediate caller. This member cannot be used by partially trusted or transparent code.

Versionsinformationen

Universelle Windows-Plattform
Verfügbar seit 8
.NET Framework
Verfügbar seit 1.1
Portierbare Klassenbibliothek
Unterstützt in: portierbare .NET-Plattformen
Windows Phone Silverlight
Verfügbar seit 8.0
Windows Phone
Verfügbar seit 8.1

Siehe auch

AllocHGlobal
FreeCoTaskMem
Marshal-Klasse
System.Runtime.InteropServices-Namespace

Zurück zum Anfang

Freigeben über