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 |
関連項目
その他のリソース
参照