CoTaskMemFree function (combaseapi.h)

Frees a block of task memory previously allocated through a call to the CoTaskMemAlloc or CoTaskMemRealloc function.

Syntax

void CoTaskMemFree(
  [in, optional] _Frees_ptr_opt_ LPVOID pv
);

Parameters

[in, optional] pv

A pointer to the memory block to be freed. If this parameter is NULL, the function has no effect.

Return value

None

Remarks

The CoTaskMemFree function uses the default OLE allocator.

The number of bytes freed equals the number of bytes that were originally allocated or reallocated. After the call, the memory block pointed to by pv is invalid and can no longer be used.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header combaseapi.h (include Objbase.h)
Library Ole32.lib
DLL Ole32.dll

See also

CoTaskMemAlloc

CoTaskMemRealloc

IMalloc::Free