Legacy Document

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

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

/

AGFileGetDBCountry

Use the AGFileGetDBCountry function to obtain the script and region codes for a guide file.

OSErr AGFileGetDBCountry 
                     (AGFileFSSpecType *fileSpec,
                      AGFileDBScriptType *script,
                      AGFileDBRegionType *region);

fileSpec

A pointer to the file system specification record for the guide file.

script

A pointer to a short integer. On return, this parameter refers to the script code for the guide file specified in the fileSpec parameter.

region

A pointer to a short integer. On return, this parameter refers to the region code for the guide file specified in the fileSpec parameter.

DESCRIPTION

The AGFileGetDBCountry function returns, in the script and region parameters, the script and region code for a guide file. The guide file is specified in the fileSpec parameter.

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	-12	Directory not found or incomplete pathname
afpAccessDenied	-5000	User does not have the correct access to the file

SEE ALSO

See the chapter "Script Manager" in Inside Macintosh: Text for a complete list of script codes and region codes.