Поделиться через


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

Извлекает текущий размер указанного локального объекта памяти в байтах.

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

Синтаксис

SIZE_T LocalSize(
  [in] HLOCAL hMem
);

Параметры

[in] hMem

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

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

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

Комментарии

Размер блока памяти может быть больше, чем запрошенный при выделении памяти.

Чтобы убедиться, что блок памяти указанного объекта не был удален, вызовите функцию LocalFlags перед вызовом LocalSize.

Требования

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

См. также

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

LocalAlloc

Локальные флаги

LocalHandle

LocalReAlloc

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