Функция GlobalUnlock

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

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

Синтаксис

Параметры

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