MAPIAllocateBuffer

Область применения: Outlook 2013 | Outlook 2016

Выделяет буфер памяти.

Свойство	Значение
Файл заголовка:	Mapix.h
Реализовано в:	MAPI
Вызывающая сторона:	Клиентские приложения и поставщики услуг

SCODE MAPIAllocateBuffer(
  ULONG cbSize,
  LPVOID FAR * lppBuffer
);

Параметры

cbSize

[в] Размер выделенного буфера (в байтах).

lppBuffer

[out] Указатель на возвращенный выделенный буфер.

Возвращаемое значение

S_OK

Вызов выполнен успешно и вернул запрошенный буфер памяти.

Замечания

Во время обработки вызова MAPIAllocateBuffer реализация вызова получает блок памяти из операционной системы. Буфер памяти выделяется по четным байт-адресам. На платформах, где более эффективен длинный целый доступ, операционная система выделяет буфер по адресу, размер которого в байтах кратен четырем.

Вызов функции MAPIFreeBuffer освобождает буфер памяти, выделенный MAPIAllocateBuffer, вызывая функцию MAPIAllocateMore и все связанные с ней буферы, если память больше не нужна.

См. также

MAPIReallocateBuffer