NewAlias

Create a complete AliasRecord

#include <Aliases.h> Alias Manager

OSErr NewAlias( fromFile, target, alias);

FSSpec * fromFile; points to an FSSpec record specifying the starting

point for a relative path

FSSpec * target; points to the target of the AliasRecord

AliasHandle *alias ; a handle to the new AliasRecord

returns Error Code; 0=no error

You use the NewAlias function to create a complete AliasRecord.

fromFile represents the starting point for a relative path, to be used later in

a relative search. If you do not need relative path information in the

record, pass a fromFile value of NIL. If you want NewAlias to record

relative path information, pass a pointer to a valid FSSpec record in

this parameter. The two files or directories, fromFile and target ,

must reside on the same volume.

target is an FSSpec record for the target of the AliasRecord.

alias is a handle to the newly created AliasRecord. If the function fails to

create an AliasRecord, it sets alias to NIL

Returns: an operating system Error Code.

noErr (0) No error

Notes: NewAlias creates an AliasRecord that describes the specified target. It

allocates the storage, fills in the record, and puts a record handle in the

alias parameter. NewAlias always records the name and file or directory

ID of the target, its creation date, the parent directory name and ID, and the

volume name and creation date. It also records the full pathname of the

target and a collection of other information relevant to locating the target,

verifying the target, and mounting the target's volume, if necessary. You can

request that it store relative path information as well by supplying a

starting point for a relative path (see About Alias Records for a

description of relative path).

Alias Manager routines use file system specification records (FSSpec

records) to identify files, directories, and volumes. To create an FSSpec

record, call FSMakeFSSpec , described in the File Manager.

The Alias Manager routines can return the result codes listed here--or

any other applicable file system or memory management result codes.

Referenced by (8):