На главную

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 | Скачать Вниз

LocalUnlock



The LocalUnlock function decrements the lock count associated with a memory object that was allocated with the LMEM_MOVEABLE flag. This function has no effect on memory objects allocated with the LMEM_FIXED flag.

BOOL LocalUnlock(

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 memory object is still locked after decrementing the lock count, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError. If GetLastError returns NO_ERROR, the memory object is unlocked.

Remarks

The internal data structures for each memory object include a lock count that is initially zero. For movable memory objects, the LocalLock function increments the count by one, and LocalUnlock decrements the count by one. For each call that a process makes to LocalLock for an object, it must eventually call LocalUnlock. Locked memory will not be moved or discarded unless the memory object is reallocated by using the LocalReAlloc function. The memory block of a locked memory object remains locked until its lock count is decremented to zero, at which time it can be moved or discarded.

If the memory object is already unlocked, LocalUnlock returns FALSE and GetLastError reports ERROR_NOT_LOCKED. Memory objects allocated with the LMEM_FIXED flag always have a lock count of zero and cause the ERROR_NOT_LOCKED error.
A process should not rely on the return value to determine the number of times it must subsequently call LocalUnlock for the memory block.

See Also

LocalAlloc, LocalFlags, LocalLock, LocalReAlloc


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

LocalUnlock



Функциональные декременты LocalUnlock счет замка связывался объектом памяти, что был распределен флагом LMEM_MOVEABLE. Эта функция не имеет эффект на объектах памяти распределенных флагом LMEM_FIXED.

BOOL LocalUnlock(

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


Параметры

hMem

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



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

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

Замечания

Внутренние структуры данных для каждого объекта памяти включают счет блокировки, который первоначально нулевой. Для подвижных объектов памяти, функциональные приращения LocalLock счет одними, и декрементами LocalUnlock счет одним. Для каждого вызова, что процесс делает на LocalLock для объекта, он должен в конечном счете назвать LocalUnlock. Закрытая память не будет перемещена или отвергнута если объект памяти reallocated использованием функции LocalReAlloc. Блок памяти объектных остатков закрытой памяти запертой пока счет блокировки не будет decremented в нуль, в котором время может быть перемещено или отвергнуто.

Если объект памяти уже деблокирован, ЛОЖЬ возврата LocalUnlock и сообщения GetLastError ERROR_NOT_LOCKED. Объекты Памяти распределенные LMEM_FIXED сигнализируют всегда иметь счет блокировки нуля и вызывать ошибку ERROR_NOT_LOCKED.
Процесс не должен доверяться в обратную величину, чтобы определять раз (а) это должно впоследствии призвать LocalUnlock к блоку памяти.

Смотри Также

LocalAlloc, LocalFlags, LocalLock, LocalReAlloc


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