Функция FreeResource (libloaderapi.h)

Статья
07/21/2023

Примечание

Эта функция устарела и поддерживается только для обратной совместимости с 16-разрядной версией Windows. Для 32-разрядных приложений Windows не нужно освобождать ресурсы, загруженные с помощью LoadResource. Для современных версий Windows эта функция всегда возвращает значение FALSE.

Уменьшает (уменьшает на один) количество ссылок загруженного ресурса. Когда количество ссылок достигает нуля, память, занятая ресурсом, освобождается.

Синтаксис

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Параметры

[in] hResData

Тип: HGLOBAL

Дескриптор ресурса. Предполагается, что hglbResource был создан LoadResource.

Возвращаемое значение

Тип: BOOL

Если вызов функции заканчивается удачно, возвращается нулевое значение.

Если функция завершается сбоем, возвращаемое значение не равно нулю, что указывает на то, что ресурс не был освобожден.

Тип ресурса	Замена FreeResource
Accelerator	DestroyAcceleratorTable
Bitmap	DeleteObject
Курсор	DestroyCursor
Значок	DestroyIcon
Меню	DestroyMenu

Система автоматически удаляет эти ресурсы, когда процесс, создавший их, завершается. Однако вызов соответствующей функции экономит память. Дополнительные сведения см. в разделе LoadResource.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	libloaderapi.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll