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