LocalSize

Функция LocalSize позволяет определить текущий размер в байтах объекта локальной памяти.

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

function LocalSize(
  hMem: HLOCAL      // декскриптор объекта локальной памяти
): UINT; stdcall;

Параметры

hMem [in]
Дескриптор объекта локальной памяти, размер которого запрашивается. Должен быть получен путем вызова функций LocalAlloc или LocalReAlloc.

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

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

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

Описание

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

Для того, чтобы убедиться в том, что указанный объект локальной памяти не является уничтоженным, следует выполнить вызов LocalFlags перед вызовом LocalSize.

Требования

Windows NT/2000: Требуется Windows NT 3.1 или более поздняя версия
Windows 95/98: Требуется Windows 95 или более поздняя версия
Бибиотека: Kernel32.dll
Подключаемый модуль: Windows

Смотри также:

LocalShrink

LocalUnlock

© Mystic, 2002