Get1NamedResource

1-deep read a named resource; get its handle

#include <Resources.h> Resource Manager

ResType rType ; resource type, e.g., 'FONT'

ConstStr255Param rName ; address of length-prefixed text (e.g., "\pgeneva")

returns handle leading to the resource data

Get1NamedResource works like Get1Resource, except that instead of a

resource ID number, you specify a resource name.

rType is a 4-byte ResType value. It identifies the resource type you want

read into memory (e.g., 'FONT', 'WIND', etc.)

rName is the address of a Pascal-style length-prefixed string. It must

match a name in the current resource file except that character case

is not significant (e.g., "MyMdef" matches "mymdef" or "MYMDEF").

Returns: a handle which leads to the resource data. A return value of NIL

indicates an error - either the resource can not be found or it will

not fit into memory. See ResError.

Notes: This function is the "1-deep" version of GetNamedResource. It obtains

resources only from the current resource file (see UseResFile). Refer to

Referenced by (4):