Legacy Document

Inside Macintosh: Files /

Chapter 4 - Alias Manager / Alias Manager Reference

Alias Manager Routines / Creating and Updating Alias Records

NewAliasMinimalFromFullPath

You use the function NewAliasMinimalFromFullPath to quickly create an alias record that contains only the full pathname of the target.

FUNCTION NewAliasMinimalFromFullPath
                  (fullPathLength: Integer; fullPath: Ptr; 
                     zoneName: Str32; serverName: Str31;
                     VAR alias: AliasHandle): OSErr;

fullPathLength

The number of characters in the full pathname of the target.

fullPath

A pointer to a buffer that contains the full pathname of the target. The full pathname starts with the name of the volume, includes all of the directory names in the path to the target, and ends with the target name. (For a description of pathnames, see the chapter "File Manager" in this book.)

zoneName

The AppleTalk zone name of the AppleShare volume on which the target resides. Set this parameter to a null string if you do not need it.

serverName

The AppleTalk server name of the AppleShare volume on which the target resides. Set this parameter to a null string if you do not need it.

alias

A handle to the newly created alias record. If the function fails to create an alias record, it sets alias to NIL.

DESCRIPTION

The NewAliasMinimalFromFullPath function creates an alias record that identifies the target by full pathname. You can call NewAliasMinimalFromFullPath to create an alias record for a file that doesn't exist or that resides on an unmounted volume.

The NewAliasMinimalFromFullPath function uses the standard alias record data structure, but it fills in only the information provided in the input parameters. You can therefore use NewAliasMinimalFromFullPath to create alias records for targets on unmounted volumes.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for NewAliasMinimalFromFullPath are

Trap macro	Selector
_AliasDispatch	$0009

RESULT CODES

noErr	0	No error
paramErr	-50	Parameter error