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