На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

LocalFree



The LocalFree function frees the specified local memory object and invalidates its handle.

HLOCAL LocalFree(

HLOCAL hMem // handle of local memory object
);


Parameters

hMem

Identifies the local memory object. This handle is returned by either the LocalAlloc or LocalReAlloc function.



Return Values

If the function succeeds, the return value is NULL.
If the function fails, the return value is equal to the handle of the local memory object. To get extended error information, call GetLastError.

Remarks

If the process tries to examine or modify the memory after it has been freed, heap corruption may occur or an access violation exception (EXCEPTION_ACCESS_VIOLATION) may be generated.
If the hMem parameter is NULL, LocalFree ignores the parameter and returns NULL.
LocalFree succeeds even if the memory object is locked by a previous call to the LocalLock function. The LocalLock function locks a local memory object and increments the lock count by one. The LocalUnlock function unlocks it and decrements the lock count by one. To get the lock count of a local memory object, use the LocalFlags function. LocalFree will free a locked memory object. A locked memory object has a lock count greater than zero.

Both GlobalFree and LocalFree will free a locked memory object. However, if you run an application under a debug version of Windows NT or Windows 95, both GlobalFree and LocalFree will issue a message that tells you that this is happening. If you are debugging the application, GlobalFree and LocalFree will enter a hard-coded breakpoint just before freeing a locked object. This lets you double-check the intended behavior.

See Also

GlobalFree, LocalAlloc, LocalFlags, LocalLock, LocalReAlloc, LocalUnlock


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

LocalFree



Функция LocalFree освобождает определенную локальную память возражать и аннулирует свою ручку.

HLOCAL LocalFree(

РУЧКА HLOCAL hMem // локального объекта памяти
);


Параметры

hMem

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



Обратные Величины

Если функция добивается успеха, обратная величина НЕДЕЙСТВИТЕЛЬНА.
Если функция терпит неудачу, обратная величина равняется ручке локального объекта памяти. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

Если процесс пытается изучать или модифицировать память после того, как он будет освобожден, коррупция кучи может произойти или исключение нарушения доступа (EXCEPTION_ACCESS_VIOLATION) может быть сгенерировано.
Если параметр hMem НЕДЕЙСТВИТЕЛЕН, LocalFree игнорирует параметр и возвращает НЕДЕЙСТВИТЕЛЬНЫЙ.
LocalFree ДОБИВАЕТСЯ успеха даже если бы объект памяти заперт предшествующим вызовом в функцию LocalLock. Функция LocalLock запирает локальную память возражать и увеличивает счет блокировки одним. Функция LocalUnlock деблокирует это и декрементам счет блокировки одним. Для того, чтобы получать счет блокировки локального объекта памяти, используйте функцию LocalFlags. LocalFree ОСВОБОДИТ закрытый объект памяти. Закрытый объект памяти имеет счет блокировки больше, чем нуль.

Как GlobalFree так и LocalFree освободит закрытый объект памяти. Тем не менее, если Вы запускаете приложение под отладочной версией Windows NT или Windows 95, как GlobalFree так и LocalFree выпустит сообщение, которое сообщает Вам, что это происходит. Если Вы отлаживаете приложение, GlobalFree и LocalFree введет трудно-закодировавшее точечный разрыв точный перед освобождением закрытого объекта. Это позволяет Вам двойное количество-проверять предполагаемое поведение.

Смотри Также

GlobalFree, LocalAlloc, LocalFlags, LocalLock, LocalReAlloc, LocalUnlock


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz