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 回の呼び出しで両方のバッファーを解放できます。