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

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

备注

MAPIAllocate 更多 调用处理期间,调用实现会从操作系统获取内存块。 内存缓冲区在偶数字节地址上分配。 在长整型访问效率更高的平台上,操作系统在字节大小为 4 的倍数的地址上分配缓冲区。

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