Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Удаляет указанный объект локальной памяти. Число блокировок объекта памяти должно быть равно нулю.
Заметка Локальные функции имеют большую нагрузку и обеспечивают меньше возможностей, чем другие функции управления памятью. Новые приложения должны использовать функции кучи , если документация не указывает, что локальная функция должна использоваться. Дополнительные сведения см. в глобальных и локальных функций.
Синтаксис
HLOCAL LocalDiscard(
[in] HLOCAL h
);
Параметры
[in] h
Дескриптор локальной памяти. Этот дескриптор возвращается функцией LocalAlloc или LocalReAlloc .
Возвращаемое значение
Тип: HLOCAL
Если функция выполнена успешно, возвращаемое значение является дескриптором для локального объекта памяти. Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
Хотя LocalDiscard удаляет блок памяти объекта, дескриптор объекта остается допустимым. Затем процесс может передать дескриптор функции LocalReAlloc , чтобы выделить другой локальный объект памяти, идентифицированный тем же дескриптором.
Требования
| Требование | Ценность |
|---|---|
| Минимальный поддерживаемый клиент | Windows XP [только классические приложения] |
| минимальный поддерживаемый сервер | Windows Server 2003 [только классические приложения] |
| целевая платформа | Виндоус |
| Заголовок | minwinbase.h (включая Windows.h) |