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

另请参阅

DeleteObject

DestroyAcceleratorTable

DestroyCursor

DestroyIcon

DestroyMenu

LoadResource

其他资源

引用