FreeResource function
[This function is obsolete and is only supported for backward compatibility with 16-bit Windows. For 32-bit Windows applications, it is not necessary to free the resources loaded using LoadResource. If used on 32 or 64-bit Windows systems, this function will return FALSE.]
Decrements (decreases by one) the reference count of a loaded resource. When the reference count reaches zero, the memory occupied by the resource is freed.
Syntax
BOOL WINAPI FreeResource( _In_ HGLOBAL hglbResource );
Parameters
- hglbResource [in]
-
Type: HGLOBAL
A handle of the resource. It is assumed that hglbResource was created by LoadResource.
Return value
Type: BOOL
If the function succeeds, the return value is zero.
If the function fails, the return value is nonzero, which indicates that the resource has not been freed.
Remarks
For resources loaded with other functions, FreeResource has been replaced by the following functions:
| Resource type | FreeResource replacement |
|---|---|
| Accelerator | DestroyAcceleratorTable |
| Bitmap | DeleteObject |
| Cursor | DestroyCursor |
| Icon | DestroyIcon |
| Menu | DestroyMenu |
The reference count for a resource is incremented (increased by one) each time an application calls the LoadResource function for the resource.
The system automatically deletes these resources when the process that created them terminates. However, calling the appropriate function saves memory. For more information, see LoadResource.
Requirements
|
Minimum supported client |
Windows 2000 Professional [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows 2000 Server [desktop apps only] |
|
Header |
|
|
Library |
|
|
DLL |
|
See also
- Reference
- LoadResource
- DestroyAcceleratorTable
- DestroyCursor
- DestroyIcon
- DestroyMenu
- Other Resources
- DeleteObject