CoGetMalloc function (combaseapi.h)

Retrieves a pointer to the default OLE task memory allocator (which supports the system implementation of the IMalloc interface) so applications can call its methods to manage memory.

Syntax

HRESULT CoGetMalloc(
  [in]  DWORD    dwMemContext,
  [out] LPMALLOC *ppMalloc
);

Parameters

[in] dwMemContext

This parameter must be 1.

[out] ppMalloc

The address of an IMalloc* pointer variable that receives the interface pointer to the memory allocator.

Return value

This function can return the standard return values S_OK, E_INVALIDARG, and E_OUTOFMEMORY.

Remarks

The pointer to the IMalloc interface pointer received through the ppMalloc parameter cannot be used from a remote process; each process must have its own allocator.

Requirements

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

See also

CoTaskMemAlloc

IMalloc