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

Статья
08/27/2023

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

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

Синтаксис

UINT LocalFlags(
  [in] HLOCAL hMem
);

Параметры

[in] hMem

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

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

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

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

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

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

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

Требования

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