На главную

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

GlobalFree



The GlobalFree function frees the specified global memory object and invalidates its handle.

HGLOBAL GlobalFree(

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 function succeeds, the return value is NULL.
If the function fails, the return value is equal to the handle of the global memory object. To get extended error information, call GetLastError.

Remarks

Heap corruption or an access violation exception (EXCEPTION_ACCESS_VIOLATION) may occur if the process tries to examine or modify the memory after it has been freed.
If the hgblMem parameter is NULL, GlobalFree fails and the system generates an access violation exception.
Both GlobalFree and LocalFree will free a locked memory object. A locked memory object has a lock count greater than zero. The GlobalLock function locks a global memory object and increments the lock count by one. The GlobalUnlock function unlocks it and decrements the lock count by one. To get the lock count of a global memory object, use the GlobalFlags function.

Windows NT: However, if an application is running under a debug (DBG) version of Windows NT, such as the one distributed on the SDK CD-ROM, both GlobalFree and LocalFree enter a breakpoint just before freeing a locked object. This lets a programmer double-check the intended behavior. Typing G while using the debugger in this situation lets the freeing operation occur.

See Also

GlobalAlloc, GlobalFlags, GlobalLock, GlobalReAlloc, GlobalUnlock, LocalFree


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

GlobalFree



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

HGLOBAL GlobalFree(

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


Параметры

hMem

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



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

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

Замечания

Нагромождать коррупцию или исключение нарушения доступа (EXCEPTION_ACCESS_VIOLATION) может произойти если процесс пытается изучать или модифицировать память после того, как он будет освобожден.
Если параметр hgblMem НЕДЕЙСТВИТЕЛЕН, GlobalFree терпит неудачу и система генерирует исключение нарушения доступа.
Как GlobalFree так и LocalFree освободит закрытый объект памяти. Закрытый объект памяти имеет счет блокировки больше, чем нуль. Функция GlobalLock запирает глобальную память возражать и увеличивает счет блокировки одним. Функция GlobalUnlock деблокирует это и декрементам счет блокировки одним. Для того, чтобы получать счет блокировки глобального объекта памяти, используйте функцию GlobalFlags.

Windows NT: Тем не менее, если приложение работает под отладкой (DBG) версией Windows NT, как например, один распространенное на SDK CD-ROM, как GlobalFree так и LocalFree вводит точечный разрыв точный перед освобождением закрытого объекта. Это позволяет, чтобы двойное количество программиста-проверяет предполагаемое поведение. Занесение G при использовании отладчика в этой ситуации позволяет, чтобы освобождающая операция происходит.

Смотри Также

GlobalAlloc, GlobalFlags, GlobalLock, GlobalReAlloc, GlobalUnlock, LocalFree


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