Функция FreeResource (libloaderapi.h)
Примечание
Эта функция устарела и поддерживается только для обратной совместимости с 16-разрядной версией Windows. Для 32-разрядных приложений Windows не нужно освобождать ресурсы, загруженные с помощью LoadResource. Для современных версий Windows эта функция всегда возвращает значение FALSE.
Уменьшает (уменьшает на один) количество ссылок загруженного ресурса. Когда количество ссылок достигает нуля, память, занятая ресурсом, освобождается.
Синтаксис
BOOL FreeResource(
[in] HGLOBAL hResData
);
Параметры
[in] hResData
Тип: HGLOBAL
Дескриптор ресурса. Предполагается, что hglbResource был создан LoadResource.
Возвращаемое значение
Тип: BOOL
Если вызов функции заканчивается удачно, возвращается нулевое значение.
Если функция завершается сбоем, возвращаемое значение не равно нулю, что указывает на то, что ресурс не был освобожден.
Комментарии
Для ресурсов, загруженных с другими функциями, FreeResource заменен следующими функциями:
| Тип ресурса | Замена FreeResource |
|---|---|
| Accelerator | DestroyAcceleratorTable |
| Bitmap | DeleteObject |
| Курсор | DestroyCursor |
| Значок | DestroyIcon |
| Меню | DestroyMenu |
Количество ссылок для ресурса увеличивается (увеличивается на единицу) каждый раз, когда приложение вызывает функцию LoadResource для ресурса.
Система автоматически удаляет эти ресурсы, когда процесс, создавший их, завершается. Однако вызов соответствующей функции экономит память. Дополнительные сведения см. в разделе LoadResource.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | libloaderapi.h (включая Windows.h) |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |
См. также
Другие ресурсы
Справочные материалы