На главную

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

GlobalUnlock



The GlobalUnlock function decrements the lock count associated with a memory object that was allocated with the GMEM_MOVEABLE flag. This function has no effect on memory objects allocated with the GMEM_FIXED flag.

BOOL GlobalUnlock(

HGLOBAL hMem // handle to the global memory object
);


Parameters

hMem

Identifies the global memory object. This handle is returned by either the GlobalAlloc or GlobalReAlloc function.



Return Values

If the memory object is still locked after decrementing the lock count, the return value is a nonzero value.
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 GlobalLock function increments the count by one, and GlobalUnlock decrements the count by one. For each call that a process makes to GlobalLock for an object, it must eventually call GlobalUnlock. Locked memory will not be moved or discarded, unless the memory object is reallocated by using the GlobalReAlloc 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.

Memory objects allocated with the GMEM_FIXED flag always have a lock count of zero. If the specified memory block is fixed memory, this function returns TRUE.
If the memory object is already unlocked, GlobalUnlock 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 GlobalUnlock for a memory object.

See Also

GlobalAlloc, GlobalFlags, GlobalLock, GlobalReAlloc


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

GlobalUnlock



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

BOOL GlobalUnlock(

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


Параметры

hMem

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



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

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

Замечания

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

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

Смотри Также

GlobalAlloc, GlobalFlags, GlobalLock, GlobalReAlloc


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