MAPIAllocateBuffer
適用対象: Outlook 2013 | Outlook 2016
メモリ バッファーを割り当てます。
| プロパティ | 値 |
|---|---|
| ヘッダー ファイル: |
Mapix.h |
| 実装元: |
MAPI |
| 呼び出し元: |
クライアント アプリケーションとサービス プロバイダー |
SCODE MAPIAllocateBuffer(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
パラメーター
Cbsize
[in]割り当てられるバッファーのサイズ (バイト単位)。
lppBuffer
[out]返された割り当て済みバッファーへのポインター。
戻り値
S_OK
呼び出しが成功し、要求されたメモリ バッファーが返されました。
注釈
MAPIAllocateBuffer 呼び出し処理中に、呼び出し元の実装はオペレーティング システムからメモリ ブロックを取得します。 メモリ バッファーは、偶数バイト アドレスに割り当てられます。 長整数アクセスの方が効率的なプラットフォームでは、オペレーティング システムは、サイズが 4 の倍数であるアドレスにバッファーを割り当てます。
MAPIFreeBuffer 関数を呼び出すと、MAPIAllocateBuffer によって割り当てられたメモリ バッファーが解放されます。これは、MAPIAllocateMore 関数と、メモリが不要になったときに、それにリンクされているバッファーを呼び出すことによって行います。