Функция GlobalFlags (winbase.h)
Извлекает сведения об указанном объекте глобальной памяти.
Синтаксис
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 |