FreeResource 関数 (libloaderapi.h)

注意

この関数は古く、16 ビット Windows との下位互換性のためにのみサポートされています。 32 ビット Windows アプリケーションの場合、 LoadResource を使用して読み込まれたリソースを解放する必要はありません。 最新バージョンの Windows の場合、この関数は常に FALSE を返します。

読み込まれたリソースの参照カウントをデクリメント (1 ずつ減少) します。 参照カウントが 0 に達すると、リソースによって占有されているメモリが解放されます。

構文

BOOL FreeResource(
  [in] HGLOBAL hResData
);

パラメーター

[in] hResData

種類: HGLOBAL

リソースのハンドル。 hglbResource は LoadResource によって作成されたものと見なされます。

戻り値

種類: BOOL

関数が成功した場合の戻り値は 0 です。

関数が失敗した場合、戻り値は 0 以外であり、リソースが解放されていないことを示します。

注釈

他の関数で読み込まれたリソースの場合、 FreeResource は次の関数に置き換えられました。

リソースの種類 FreeResource の置換
アクセラレータ DestroyAcceleratorTable
Bitmap DeleteObject
カーソル DestroyCursor
アイコン DestroyIcon
メニュー DestroyMenu
 

リソースの参照カウントは、アプリケーションがリソースの LoadResource 関数を呼び出すたびにインクリメント (1 ずつ増加) されます。

これらのリソースを作成したプロセスが終了すると、これらのリソースは自動的に削除されます。 ただし、適切な関数を呼び出すとメモリが節約されます。 詳細については、「 LoadResource」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー libloaderapi.h (Windows.h を含む)
Library Kernel32.lib
[DLL] Kernel32.dll

関連項目

DeleteObject

DestroyAcceleratorTable

DestroyCursor

DestroyIcon

DestroyMenu

LoadResource

その他のリソース

参照