MAPIAllocateBuffer.3w

Langue: en

Version: Jun 2009 (debian - 07/07/09)

Section: 3 (Bibliothèques de fonctions)

Sommaire

NAME

MAPIAllocateBuffer (MAPI32.12)

SYNOPSIS

SCODE MAPIAllocateBuffer
 (
  ULONG   cbSize,
  LPVOID* lppBuffer
 )

DESCRIPTION

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

Defined in "mapix.h".

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

Debug channel "mapi".