Функция GlobalUnlock

(В линейках ОС Windows NT и 9x не используется)


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

Синтаксис

BOOL GlobalUnlock(
HGLOBAL hglb // дескриптор разблокировываемой памяти глобальных данных
);

Параметры

hglb

Идентифицирует объект памяти глобальных данных, который будет разблокирован.

Возвращаемые значения

Возвращаемое значение - нуль, если счетчик блокировки (фиксации) объекта был уменьшен ( на единицу) до нуля. В противном случае, возвращаемое значение - не нуль.

Замечания

При перемещаемой или выгружаемой памяти эта функция уменьшает счетчик фиксации объекта. Объект полностью разблокируется и подчиняется перемещению или выгрузке, если счетчик фиксации уменьшается до нуля.

Эта функция возвращает ненулевое значение, если данный объект памяти не перемещаем. Приложение не должно зависеть от возвращаемого значения, чтобы определить сколько раз оно должно впоследствии вызвать функцию GlobalUnlock для объекта памяти.

Другие функции могут также влиять на счетчик фиксации объекта памяти. Список функций, которые оказывают влияние на счетчик блокировки (фиксации), см. в описании функции GlobalFlags.

Каждый раз, когда приложение вызывает GlobalLock для объекта, оно должно в конечном счете вызвать для этого объекта функцию GlobalUnlock.

Пример

Нижеследующий пример использует функции GlobalAlloc и GlobalLock, чтобы назначить память, а затем вызывает функции GlobalUnlock и GlobalFree, чтобы освободить ее.

HGLOBAL hglb;
void FAR* lpvBuffer;

hglb = GlobalAlloc(GPTR, 1024);
lpvBuffer = GlobalLock(hglb);
.
.
.
GlobalUnlock(hglb);
GlobalFree(hglb);

Смотри также

Обзор Устаревшие элементы программирования Windows, GlobalAlloc, GlobalFlags, GlobalFree, GlobalLock, UnlockResource

Размещение и совместимость GlobalUnlock
К Windows XP Нет
л Windows 2000 Professional Нет
и Windows NT Workstation Нет
е Windows Me Нет
н Windows 98 Нет
т Windows 95 Нет
С Windows 2003 Server Нет
е Windows 2000 Server Нет
р Windows NT Server Нет
в
е
р
Используемая библиотека -
Используемая DLL -
Заголовочный файл
- объявлено в -
- включено в -
Unicode
Замечания по платформе Применяется только в Windows версии 2.х

Назад в оглавление
На главную страницу
На оглавление справки
Переведено 28.02.2008 14:15 ©Copyright V. Sokovikov
Hosted by uCoz