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

另請參閱

DeleteObject

DestroyAcceleratorTable

DestroyCursor

DestroyIcon

DestroyMenu

LoadResource

其他資源

參考