FreeResource

From aldeid
Jump to navigation Jump to search

Description

Note
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.