MAPIAllocateBuffer3w

Usage

Overview

MAPIAllocateBuffer@8 (MAPI32.13).

Allocate a block of memory.

Params

cbSize [In] Size of the block to allocate in bytes.

lppBuffer [Out] Destination for pointer to allocated memory.

Returns

Success: S_OK. *lppBuffer is filled with a pointer to a memory block of length cbSize bytes.

Failure: MAPI_E_INVALID_PARAMETER, if lppBuffer is NULL. MAPI_E_NOT_ENOUGH_MEMORY, if the memory allocation fails.

Notes

Memory allocated with this function should be freed with MAPIFreeBuffer(3w). Further allocations of memory may be linked to the pointer returned using MAPIAllocateMore(). Linked allocations are freed when the initial pointer is feed.

Implementation

Declared in "util.h".

Implemented in "dlls/mapi32/util.c".

Debug channel "mapi".