MAPIAllocateBuffer
Область применения: Outlook 2013 | Outlook 2016
Выделяет буфер памяти.
| Свойство | Значение |
|---|---|
| Файл заголовка: |
Mapix.h |
| Реализовано в: |
MAPI |
| Вызывающая сторона: |
Клиентские приложения и поставщики услуг |
SCODE MAPIAllocateBuffer(
ULONG cbSize,
LPVOID FAR * lppBuffer
);
Параметры
cbSize
[в] Размер выделенного буфера (в байтах).
lppBuffer
[out] Указатель на возвращенный выделенный буфер.
Возвращаемое значение
S_OK
Вызов выполнен успешно и вернул запрошенный буфер памяти.
Замечания
Во время обработки вызова MAPIAllocateBuffer реализация вызова получает блок памяти из операционной системы. Буфер памяти выделяется по четным байт-адресам. На платформах, где более эффективен длинный целый доступ, операционная система выделяет буфер по адресу, размер которого в байтах кратен четырем.
Вызов функции MAPIFreeBuffer освобождает буфер памяти, выделенный MAPIAllocateBuffer, вызывая функцию MAPIAllocateMore и все связанные с ней буферы, если память больше не нужна.