Функция LocalReAlloc (winbase.h)

Статья
08/27/2023

Изменяет размер или атрибуты указанного объекта локальной памяти. Размер может увеличиваться или уменьшаться.

Примечание Локальные функции имеют большую нагрузку и предоставляют меньше возможностей, чем другие функции управления памятью. Новые приложения должны использовать функции кучи , если в документации не указано, что следует использовать локальную функцию. Дополнительные сведения см. в разделе Глобальные и локальные функции.

Синтаксис

DECLSPEC_ALLOCATOR HLOCAL LocalReAlloc(
  [in] _Frees_ptr_opt_ HLOCAL hMem,
  [in] SIZE_T                 uBytes,
  [in] UINT                   uFlags
);

Параметры

[in] hMem

Дескриптор для перераспределенного локального объекта памяти. Этот дескриптор возвращается функцией LocalAlloc или LocalReAlloc .

[in] uBytes

Новый размер блока памяти в байтах. Если uFlags указывает LMEM_MODIFY, этот параметр игнорируется.

[in] uFlags

Параметры перераспределения. Если указан LMEM_MODIFY , функция изменяет атрибуты только объекта памяти (параметр uBytes игнорируется). В противном случае функция перераспределяет объект памяти.

При необходимости можно объединить LMEM_MODIFY со следующим значением.

Значение	Значение
LMEM_MOVEABLE 0x0002	Выделяет фиксированную или перемещаемую память. Если память является заблокированным LMEM_MOVEABLE блоком памяти или блоком LMEM_FIXED памяти и этот флаг не указан, память может быть перераспределена только на месте.

Если этот параметр не указывает LMEM_MODIFY, можно использовать следующее значение.

Значение	Значение
LMEM_ZEROINIT 0x0040	Вызывает инициализацию дополнительного содержимого памяти до нуля, если размер объекта памяти увеличивается.

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

Если функция выполняется успешно, возвращаемое значение является дескриптором для перераспределенного объекта памяти.

Если функция завершается сбоем, возвращается значение NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Если LocalReAlloc перераспределяет фиксированный объект, возвращаемое значение дескриптора — это адрес первого байта блока памяти. Чтобы получить доступ к памяти, процесс может просто привести возвращаемое значение к указателю.

Требования


Минимальная версия клиента	Windows XP [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2003 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll

См. также

Глобальные и локальные функции

LocalAlloc

LocalFree

LocalLock

Функции управления памятью