MAPIAllocateMore

适用于:Outlook 2013 | Outlook 2016

分配一个内存缓冲区,该缓冲区链接到以前使用 MAPIAllocateBuffer 函数分配的另一个缓冲区。

属性
标头文件:
Mapix.h
实现者:
MAPI
调用者:
客户端应用程序和服务提供商
SCODE MAPIAllocateMore(
  ULONG cbSize,
  LPVOID lpObject,
  LPVOID FAR * lppBuffer
);

参数

cbSize

[in]要分配的新缓冲区的大小(以字节为单位)。

lpObject

[in]指向使用 MAPIAllocateBuffer 分配的现有 MAPI 缓冲区的指针。

lppBuffer

[out]指向返回的新分配缓冲区的指针。

返回值

S_OK

调用成功,并返回了指向所请求内存的指针。

注解

MAPIAllocateMore 调用处理过程中,调用实现从操作系统获取内存块。 内存缓冲区是在偶数字节地址上分配的。 在具有较长整数访问效率的平台上,操作系统在大小为字节数为四倍的地址上分配缓冲区。

释放使用 MAPIAllocateMore 分配的缓冲区的唯一方法是将 lpObject 参数中指定的缓冲区指针传递给 MAPIFreeBuffer 函 数。 使用 MAPIAllocateBufferMAPIAllocateMore 分配的内存缓冲区之间的链接使 MAPIFreeBuffer 能够通过单个调用释放这两个缓冲区。