LocalDiscard
Функция LocalFlags позволяет получить информацию об указанном объекте памяти.
Примечание: функция реализована только для совместимости с 16-битной Windows.
function LocalFlags( hMem: HLOCAL // дескриптор локального объекта памяти ): UINT; stdcall;
Параметры
hMem [in]
Дескриптор объета локальной памяти. Должен быть получен путем вызова функций
LocalAlloc или
LocalReAlloc.
Возвращаемое значение
В случае удачного завершения функция возвращает количество блокировок объекта локальной памяти.
В случае ошибки функция возвращает значение LMEM_INVALID_HANDLE, показывая, что переданный ей дескриптор не корректен. Для получения расширенной информации об ошибке следует сделать вызов GetLastError.
Описание
Младший байт младшего слова возвращаемого значения содержит количество блокировок указанного объетка локальной памяти. Для того, чтобы получить это значение, вы должны применить к возвращенному значение операцию AND со значением LMEM_LOCKCOUNT. Количество блокировок объекта памяти, выделенного с флагом LMEM_FIXED всегда равно нулю.
Старший байт младшего слова возвращаемого значения показывает с какими флагами создавался указанный объект локальной памяти. Он может быть нулевым, либо комбинацией следующих флагов:
| Флаг | Назначение |
|---|---|
LMEM_DISCARDABLE |
Игнорируется. Оставлен для совместимости с 16-битной Windows. Тем не менее в Win32 вы можете производить вызов функции LocalDiscard для того, чтобы разрушить объект в памяти не разрушая его дескриптор. |
LMEM_DISCARDED |
Указанный объект локальной памяти был разрушен. |
Требования
Windows NT/2000: Требуется Windows NT 3.1 или более поздняя версия
Windows 95/98: Требуется Windows 95 или более поздняя версия
Бибиотека: Kernel32.dll
Подключаемый модуль: Windows
Смотри также:
| LocalDiscard |
LocalFree |
© Mystic, 2002