GlobalFlags

Функция GlobalFlags позволяет получить информацию об указанном объекте памяти.

Примечание: функция реализована только для совместимости с 16-битной Windows.

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

Параметры

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

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

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

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

Описание

Младший байт младшего слова возвращаемого значения содержит количество блокировок указанного объетка глобальной памяти. Для того, чтобы получить это значение, вы должны применить к возвращенному значение операцию AND со значением GMEM_LOCKCOUNT. Количество блокировок объекта памяти, выделенного с флагом GMEM_FIXED всегда равно нулю.

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

Требования

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

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

GlobalFix

GlobalFree

© Mystic, 2002