Поделиться через


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

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

Примечание Эта функция предоставляется только для совместимости с 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

См. также

Глобальные и локальные функции

GlobalFlags

LocalAlloc

LocalDiscard

LocalLock

LocalReAlloc

LocalUnlock

Функции управления памятью