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

Статья
27.08.2023

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

Примечание Эта функция предоставляется только для совместимости с 16-разрядными версиями Windows. Новые приложения должны использовать функции кучи. Дополнительные сведения см. в подразделе "Примечания".

Синтаксис

C++

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

Параметры

[in] hMem

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

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

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

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

Байт нижнего порядка слова возвращаемого значения содержит число блокировок объекта. Чтобы получить количество блокировок из возвращаемого значения, используйте маску GMEM_LOCKCOUNT с побитовой оператором AND (&). Количество блокировок объектов памяти, выделенных GMEM_FIXED , всегда равно нулю.

Байт низкого порядка возвращаемого значения указывает на значения выделения объекта памяти. Он может быть равен нулю или GMEM_DISCARDED.

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

Требования

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