GlobalSize

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

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

function GlobalSize(
  hMem: HGLOBAL      // декскриптор объекта глобальной памяти
): DWORD; stdcall;

Параметры

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

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

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

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

Описание

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

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

Требования

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

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

GlobalReAlloc

GlobalUnfix

© Mystic, 2002