FreeResource 函数 (libloaderapi.h)
注意
此函数已过时,仅支持与 16 位 Windows 向后兼容。 对于 32 位 Windows 应用程序,无需释放使用 LoadResource 加载的资源。 对于新式版本的 Windows,此函数始终返回 FALSE。
递减 () 已加载资源的引用计数减少一个。 当引用计数达到零时,将释放资源占用的内存。
语法
BOOL FreeResource(
[in] HGLOBAL hResData
);
参数
[in] hResData
类型: HGLOBAL
资源的句柄。 假定 hglbResource 是由 LoadResource 创建的。
返回值
类型: BOOL
如果函数成功,则返回值为 0。
如果函数失败,则返回值为非零值,表示尚未释放资源。
注解
对于使用其他函数加载的资源, FreeResource 已替换为以下函数:
资源类型 | FreeResource 替换 |
---|---|
加速器 | DestroyAcceleratorTable |
Bitmap | DeleteObject |
游标 | DestroyCursor |
图标 | DestroyIcon |
菜单 | DestroyMenu |
每次应用程序调用资源的 LoadResource 函数时,资源的引用计数都会递增 (增加一) 。
创建这些资源的进程终止时,系统会自动删除这些资源。 但是,调用相应的函数可节省内存。 有关详细信息,请参阅 LoadResource。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | libloaderapi.h (包括 Windows.h) |
Library | Kernel32.lib |
DLL | Kernel32.dll |
另请参阅
其他资源
引用