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 typeFreeResource 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

Winbase.h (include Windows.h)

Library

Kernel32.lib

DLL

Kernel32.dll

See also

Reference
LoadResource
DestroyAcceleratorTable
DestroyCursor
DestroyIcon
DestroyMenu
Other Resources
DeleteObject

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.