Legacy Document

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.

---

© Apple Computer, Inc.
2 JUL 1996