Legacy Document

Inside Macintosh: More Macintosh Toolbox /

Chapter 1 - Resource Manager / Resource Manager Reference

Resource Manager Routines / Getting and Setting Resource Fork Attributes

GetResFileAttrs

You can use the GetResFileAttrs function to get the attributes of a resource fork.

FUNCTION GetResFileAttrs (refNum: Integer): Integer;

refNum

A file reference number for the resource fork whose attributes you want to get.

DESCRIPTION

Given a file reference number, the GetResFileAttrs function returns the attributes of the file's resource fork. Specify 0 in the refNum parameter to get the attributes of the System file's resource fork. If there's no open resource fork for the given file reference number, GetResFileAttrs does nothing, and the ResError function returns the result code resFNotFound.

Like individual resources, resource forks have attributes that are specified by bits in the low-order byte of a word. The Resource Manager provides the following masks for testing these bits:

CONST
   mapReadOnly    =  128;  {set if file is read-only}
   mapCompact     =  64;   {set to compact file on update}
   mapChanged     =  32;   {set to write map on update}

When the mapReadOnly attribute is set to 1, the Resource Manager doesn't write anything to the resource fork on disk. It also doesn't check whether the resource data can be written to disk when the resource map is modified. When this attribute is set to 1, the UpdateResFile and WriteResource procedures do nothing, but the ResError function returns the result code noErr.

When the mapCompact attribute is set to 1, the Resource Manager compacts the resource fork when it updates the file. The Resource Manager sets this attribute when a resource is removed or when a resource is made larger and thus must be written at the end of a resource fork. You may want to set the mapCompact attribute to force the Resource Manager to compact a resource fork when your changes have made resources smaller.

When the mapChanged attribute is set to 1, the Resource Manager writes the resource map to disk when the file is updated. For example, you can set mapChanged if you've changed resource attributes only and don't want to call ChangedResource because you don't want to write the resource data to disk.

SPECIAL CONSIDERATIONS

The Resource Manager sets the mapChanged attribute for the resource fork when you call the ChangedResource, the AddResource, or the RemoveResource procedure.

RESULT CODES

noErr	0	No error
resFNotFound	-193	Resource file not found

SEE ALSO

To check for errors, call the ResError function as described on page 1-47.

For descriptions of the ChangedResource and AddResource procedures, see page 1-83 and page 1-85, respectively. For descriptions of the UpdateResFile and WriteResource procedures, see page 1-87 and page 1-88, respectively. For a description of the RemoveResource procedure, see page 1-103.