The MAPIAllocateBuffer function allocates a memory buffer.
SCODE MAPIAllocateBuffer( ULONG cbSize, LPVOID FAR* lppBuffer );
[in] Size, in bytes, of the buffer to be allocated.
[out] Pointer to the returned allocated buffer.
The call succeeded and has returned the expected value or values.
During MAPIAllocateBuffer call processing, the calling implementation acquires a block of memory from the operating system. The memory buffer is allocated on an even-numbered byte address. On platforms where long integer access is more efficient, the operating system allocates the buffer on an address whose size in bytes is a multiple of four.
Calling the MAPIFreeBuffer function releases the memory buffer allocated by MAPIAllocateBuffer and also releases any additional buffers that have been linked to it through the MAPIAllocateMore function.
|Windows Embedded CE||Windows CE 3.0 and later|
|Windows Mobile||Pocket PC 2002 and later, Smartphone 2002 and later|