Marshal.AllocCoTaskMem(Int32) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Allocates a block of memory of specified size from the COM task memory allocator.
public:
static IntPtr AllocCoTaskMem(int cb);[System.Security.SecurityCritical]
public static IntPtr AllocCoTaskMem (int cb);public static IntPtr AllocCoTaskMem (int cb);[<System.Security.SecurityCritical>]
static member AllocCoTaskMem : int -> nativeintstatic member AllocCoTaskMem : int -> nativeintPublic Shared Function AllocCoTaskMem (cb As Integer) As IntPtrParameters
- cb
- Int32
The size of the block of memory to be allocated.
Returns
nativeint
An integer representing the address of the block of memory allocated. This memory must be released with FreeCoTaskMem(IntPtr).
- Attributes
Exceptions
There is insufficient memory to satisfy the request.
Remarks
AllocCoTaskMem is one of two memory allocation API methods in the Marshal class. (Marshal.AllocHGlobal is the other.) The initial memory content returned is undefined, and the allocated memory can be larger than the requested number of bytes. This method exposes the COM CoTaskMemAlloc function, which is referred to as the COM task memory allocator.
