Marshal.FreeCoTaskMem(IntPtr) Method

Definition

Frees a block of memory allocated by the unmanaged COM task memory allocator.

C#
[System.Security.SecurityCritical]
public static void FreeCoTaskMem (IntPtr ptr);
C#
public static void FreeCoTaskMem (IntPtr ptr);

Parameters

ptr
IntPtr

The address of the memory to be freed.

Attributes

Remarks

You can use FreeCoTaskMem to free any memory allocated by AllocCoTaskMem, ReAllocCoTaskMem, or any equivalent unmanaged method. If the ptr parameter is IntPtr.Zero, the method does nothing.

FreeCoTaskMem exposes the COM CoTaskMemFree function, which frees all bytes so that you can no longer use the memory that the ptr parameter points to.

In addition to FreeCoTaskMem, the Marshal class provides two other memory-deallocation methods: DestroyStructure and FreeHGlobal.

Applies to

Product 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
.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

See also