Share via


MAPIAllocateMore

Send Feedback

The MAPIAllocateMore function allocates a memory buffer that is linked to another buffer previously allocated with the MAPIAllocateBuffer function.

Syntax

SCODE MAPIAllocateMore(
  ULONG cbSize,
  LPVOID lpObject, 
  LPVOID FAR * lppBuffer 
);

Parameters

  • cbSize
    [in] Size, in bytes, of the new buffer to be allocated.
  • lpObject
    [in] Pointer to an existing MAPI buffer allocated using MAPIAllocateBuffer.
  • lppBuffer
    [out] Pointer to the returned, newly allocated buffer.

Return Values

  • S_OK
    The call succeeded and has returned the expected value or values.

Remarks

During MAPIAllocateMore 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.

The only way to release a buffer allocated with MAPIAllocateMore is to pass the buffer pointer specified in the lpObject parameter to the MAPIFreeBuffer function. The link between the memory buffers allocated with MAPIAllocateBuffer and MAPIAllocateMore enables MAPIFreeBuffer to release both buffers with a single call.

Requirements

Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
vHeader: mapix.h
Library: cemapi.lib

See Also

MAPI Functions | Messaging

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.