Метод IMalloc::Alloc (objidl.h)

  • Статья

Выделяет блок памяти.

Синтаксис

void * Alloc(
  [in] SIZE_T cb
);

Параметры

[in] cb

Размер выделенного блока памяти в байтах.

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

Если метод выполнен успешно, возвращаемое значение является указателем на выделенный блок памяти. В противном случае он имеет значение NULL.

Приложения всегда должны проверка возвращаемое значение из этого метода, даже при запросе небольших объемов памяти, так как нет никакой гарантии, что память будет выделена.

Комментарии

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

Если cb равен нулю, Alloc выделяет элемент нулевой длины и возвращает допустимый указатель на этот элемент. Если доступной памяти недостаточно, Функция Alloc возвращает значение NULL.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header objidl.h

См. также раздел

CoTaskMemAlloc

IMalloc