Legacy Documentclose button

Important: The information in this document is obsolete and should not be used for new development.

Previous Book Contents Book Index Next

Inside Macintosh: Files /
Chapter 3 - Standard File Package / Standard File Package Reference
Data Structures


Original Standard File Reply Record

When you use one of the original Standard File Package procedures SFPutFile, SFGetFile, SFPPutFile, or SFPGetFile, you pass a reply record of type SFReply.

SFReply =
RECORD
   good:       Boolean;    {TRUE if user did not cancel}
   copy:       Boolean;    {reserved}
   fType:      OSType;     {file type}
   vRefNum:    Integer;    {working directory reference number}
   version:    Integer;    {reserved}
   fName:      Str63;      {filename}
END;

Field Description
good
Reports whether the reply record is valid. The value is TRUE after the user clicks Save or Open; FALSE after the user clicks Cancel. When the user has completed the dialog box, the other fields in the reply record are valid only if the value of good is TRUE.
copy
Reserved.
fType
Contains the file type of the selected file. (File types are described in the chapter "Finder Interface" of Inside Macintosh: Macintosh Toolbox Essentials.) Only SFGetFile and SFPGetFile return a file type in this field.
vRefNum
Contains the working directory reference number of the selected file.
version
Reserved.
fName
Contains the name of the selected file.
Note
In spite of its name, the vRefNum field does not contain a volume reference number. Instead, it contains a working directory reference number, which encodes both the volume reference number and the parent directory ID of the selected file. You can obtain the volume reference number and directory ID of the file by calling GetWDInfo or PBGetWDInfo. See the chapter "File Manager" in this book for details about working directory reference numbers.

Previous Book Contents Book Index Next

© Apple Computer, Inc.
2 JUL 1996