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 函式。 使用 MAPIAllocateBuffer 和 MAPIAllocateMore 配置的記憶體緩衝區之間的連結可讓 MAPIFreeBuffer 透過單一呼叫釋放這兩個緩衝區。