GetResAttrs

GetResAttrs Get resource attributes ( purgeable, locked, etc.)

#include <Resources.h> Resource Manager

short GetResAttrs(rHandle );

Handle rHandle ; handle to an existing resource

returns attributes of a resource; e.g., resChanged, et al.

GetResAttrs lets you examine resource attributes to find out various facets

of how a resource is handled. It is typically used only by

resource-management utilities such as ResEdit.

rHandle is a resource handle. It is a handle obtained via GetResource,

Returns: a signed short; a bit record identifying the current resource

attributes of rHandle (see below). Note: Use ResError to check

whether or not this function succeeded before assuming a valid return

value.

Notes: The high-order byte of the return value is un defined. The rest of the

attribute is a bit record formatted as follows:

The named constants resChanged, resPreload, etc. are defined in

Resources.h. You might use this function to get a resource's current

attributes so you can use SetResAttrs more efficiently (see SetResAttrs

for an example of this technique).

Do not modify the resChanged attribute directly. Use ChangedResource

if you have changed data in a resource and wish to preserve the change.

The resLocked attribute overrides resPurgeable. When locked, a resource

does not move around in memory and will not be purged in a memory

shortage.

The resProtected attribute prohibits all modifications via

Resource Manager functions. You can not change the ID, name, or the

contents of the resource and you can not delete it from the resource list.

You can use SetResAttrs to change attributes, including resProtected.

Use SetResInfo to change a resource's name and/or ID.

Referenced by (14):