На главную

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

LocalDiscard



The LocalDiscard function discards the specified local memory object. The lock count of the memory object must be zero.

HLOCAL LocalDiscard(

HLOCAL hlocMem // handle of local memory object
);


Parameters

hlocMem

Identifies the local memory object. This handle is returned by either the LocalAlloc or LocalReAlloc function.



Return Values

If the function succeeds, the return value is the handle of the local memory object.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

LocalDiscard discards only local objects allocated by a process with the LMEM_DISCARDABLE flag. If a process attempts to discard a fixed or locked object, the function fails.
Although LocalDiscard discards the object's memory block, the handle of the object remains valid. A process can subsequently pass the handle to the LocalReAlloc function to allocate another local memory object identified by the same handle.

See Also

LocalAlloc, LocalReAlloc


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

LocalDiscard



Функция LocalDiscard отвергает определенный локальный объект памяти. Счет замка объекта памяти должен - нулевым.

HLOCAL LocalDiscard(

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


Параметры

hlocMem

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



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

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

Замечания

LocalDiscard ОТВЕРГАЕТ только локальные объекты распределенные процессом с флагом LMEM_DISCARDABLE. Если процесс пытается отвергать фиксированный или закрытый объект, функция терпит неудачу.
Хотя LocalDiscard отвергает объектного блока памяти, ручка объекта остается в силе. Процесс может впоследствии передать ручку в функцию LocalReAlloc, чтобы распределять другой локальный объект памяти идентифицированный той же ручкой.

Смотри Также

LocalAlloc, LocalReAlloc


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