SetResInfo

Set the name and ID of a resource

#include <Resources.h> Resource Manager

void SetResInfo( rHandle, rID, rName );

Handle rHandle ; handle leading to resource data

short rID ; specifies 2-byte resource ID

ConstStr255Param rName ; address of length-prefixed name; NIL=no change

Given a resource handle, SetResInfo sets the resource's ID and, optionally,

its name.

rHandle is a resource handle. It should be a valid value obtained via

rID specifies the desired new resource ID. If you wish to leave the ID

un changed, first use GetResInfo to obtain the current ID.

rName is the address of a length-prefixed Pascal-style string containing

the desired new name. Use an empty string (e.g., "\p") to delete the

name. Use rName =0 to specify the resource's current name.

Returns: none (if rHandle is not a resource handle, ResError will return

the resNotFound error)

Notes: This is typically used only by resource-management utilities such as

ResEdit. It is rare for a normal application program to need to change a

resource name or ID. It is unwise to change system resource information

since other applications may depend on the current values remaining

un changed.

If ChangedResource has been called for any resource in the same file,

then when the file is updated (UpdateResFile) or closed (CloseResFile)

or the program terminates (ExitToShell), the changes will be written to

disk. If you want selected changes to be temporary, be sure to re store

previous values before you close the resource or terminate the application.

Referenced by (12):