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 呼び出し処理中に、呼び出し元の実装はオペレーティング システムからメモリ ブロックを取得します。 メモリ バッファーは、偶数バイト アドレスに割り当てられます。 長整数アクセスの方が効率的なプラットフォームでは、オペレーティング システムは、サイズが 4 の倍数であるアドレスにバッファーを割り当てます。
MAPIAllocateMore で割り当てられたバッファーを解放する唯一の方法は、lpObject パラメーターで指定されたバッファー ポインターを MAPIFreeBuffer 関数に渡すことです。 MAPIAllocateBuffer と MAPIAllocateMore で割り当てられたメモリ バッファー間のリンクにより、MAPIFreeBuffer は、1 回の呼び出しで両方のバッファーを解放できます。