FreeResource 函式 (libloaderapi.h)
注意
此函式已過時,且僅支援與16位 Windows 的回溯相容性。 對於 32 位 Windows 應用程式,不需要釋放使用 LoadResource 載入的資源。 對於新式 Windows 版本,此函式一律會傳回 FALSE。
遞減 (會減少一) 載入資源的參考計數。 當參考計數達到零時,會釋放資源所佔用的記憶體。
語法
BOOL FreeResource(
[in] HGLOBAL hResData
);
參數
[in] hResData
類型: HGLOBAL
資源的句柄。 假設 hglbResource 是由 LoadResource 所建立。
傳回值
類型: BOOL
如果此函式成功,則傳回值為零。
如果函式失敗,傳回值為非零值,表示資源尚未釋放。
備註
對於以其他函式載入的資源, FreeResource 已由下列函式取代:
資源類型 | FreeResource 取代 |
---|---|
加速器 | DestroyAcceleratorTable |
點陣圖 | DeleteObject |
資料指標 | DestroyCursor |
圖示 | DestroyIcon |
功能表 | DestroyMenu |
每次應用程式呼叫資源的 LoadResource 函式時,資源參考計數會遞增 (增加一) 。
當建立這些資源的進程終止時,系統會自動刪除這些資源。 不過,呼叫適當的函式可節省記憶體。 如需詳細資訊,請參閱 LoadResource。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | libloaderapi.h (包含 Windows.h) |
程式庫 | Kernel32.lib |
DLL | Kernel32.dll |
另請參閱
其他資源
參考