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 函数。 使用 MAPIAllocateBuffer 和 MAPIAllocateMore 分配的内存缓冲区之间的链接使 MAPIFreeBuffer 能够通过单个调用释放这两个缓冲区。