Legacy Document

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

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

/

AGFileGetMixinMatchSelector

Use the AGFileGetMixinMatchSelector function to determine if a Mixin guide file can be mixed in with a main guide file.

OSErr AGFileGetMixinMatchSelector
                     (AGFileFSSpecType *fileSpec,
                      OSType *mixinMatchSelector);

fileSpec

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

mixinMatchSelector

The AGFileGetMixinMatchSelector function returns, through this parameter, a four-character value that usually corresponds to the signature of the application associated with this guide file.

DESCRIPTION

The AGFileGetMixinMatchSelector function returns, through its mixinMatchSelector parameter, a four-character value corresponding to the value specified by a <Mixin Match> command in the guide file's source files. A Mixin guide file can mix in with a main guide file if their four-character values (specified by <Mixin Match> commands) match.

In addition, if the value returned in the mixinMatchSelector parameter is '****', the Mixin guide file can mix with any main 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

---

Subtopics

AGInstallCoachHandler/A>

AGRemoveCoachHandler