All DatabasesInside Mac - Basic Toolbox
ReleaseResource
ReleaseResource Discard a resource's data and its handle
#include <Resources.h> Resource Manager
void ReleaseResource(rHandle );
Handle rHandle ; existing, valid handle to a resource
This frees up all memory used by a resource and sets its handle in the
resource map to NIL. The handle must no longer be referenced as a resource.
rHandle is a handle leading to some variable length resource data. This
should be a valid handle obtained via GetResource,
GetNamedResource, etc.
Returns: none (if rHandle is not a handle to a resource, ResError will
return an error).
Notes: Use this to free up memory used for generic handles obtained via
GetResource, GetNamedResource, et. al. Manager-specific resource
calls such as GetMenu have manager-specific calls to release resources
(e.g., DisposeMenu).
Note that ReleaseResource sets the resource's handle in the resource
map to NIL. It does not set the rHandle parameter passed to it to NIL.
When you call CloseResFile (or terminate your application via
ExitToShell) all application resource handles are released automatically.
Referenced by (63):