Legacy Document

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

Inside Macintosh: Apple Guide Complete / Part 3 - Integrating Guide Files

Chapter 9 - Apple Guide API / Getting Information About Guide Files

AGFileGetDBVersion
Use the AGFileGetDBVersion function to obtain the version information of a guide file.
OSErr AGFileGetDBVersion 
                     (AGFileFSSpecType *fileSpec,
                      AGFileMajorRevType *majorRev,
                      AGFileMinorRevType *minorRev);
fileSpec
A pointer to the file system specification record for the guide file.
majorRev
A pointer to a short integer. On return, this parameter refers to the major version designation for the guide file specified in the fileSpec parameter.
minorRev
A pointer to a short integer. On return, this parameter refers to the minor version designation for the guide file specified in the fileSpec parameter.

DESCRIPTION
The AGFileGetDBVersion function returns in its parameters--majorRev and minorRev--the major and minor versions of the guide file.

RESULT CODES
noErr 0 No error
nsvErr -35 Volume doesn't exist
ioErr -36 I/O error
fnOpnErr -38 File not open
fnfErr -43 File or directory does not exist
fLckdErr -45 File is locked
rfNumErr -51 Bad reference number
dirNFErr -120 Directory not found or incomplete pathname
afpAccessDenied -5000 User does not have the correct access to the file

noErr	0	No error
nsvErr	-35	Volume doesn't exist
ioErr	-36	I/O error
fnOpnErr	-38	File not open
fnfErr	-43	File or directory does not exist
fLckdErr	-45	File is locked
rfNumErr	-51	Bad reference number
dirNFErr	-120	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access to the file