CloseResFile

Close and update resource file; free the memory it used

#include <Resources.h> Resource Manager

void CloseResFile(rfRefNum );

short rfRefNum ; resource file reference number

This updates a specified resource file (if ChangedResource has been

called), frees up the memory that was used by all its resources and its

resource map, and closes the file.

r fRefNum identifies the resource file to close. It is a value obtained from

ALL open resource files, including the system file.

Returns: none (use ResError to determine success/failure)

Notes: CloseResFile can be used as a quick way to free up memory used by

resources. It is not normally needed, since all open resource files are

closed when an application terminates.

If you wish to retain the data of one or more resources in the file, you can

use DetachResource before closing the file.

This updates the file by calling UpdateResFile; if any resource is

changed (and has been tagged as changed via ChangedResource) the

modifications will be recorded to disk. Note that if a purgeable resource has

been tagged as changed, and has been purged at the time of this call, a

0-length resource is written to disk.

Use CurResFile directly after startup to learn the r fRefNum of your

application's resource file. Use HomeResFile to learn the r fRefNum of

the file which owns a particular resource whose handle you know.

Referenced by (36):