Macintosh Development

[Home] [About Us] [People] [Information Systems]
[Kerberos for Macintosh] [Applications] [Miscellaneous Documentation]

TicketKeeperLib API

OSStatus TKAE_SendQuitApplication ();

Send quit event to ticket keeper. This will cause Ticket Keeper to remove its notification if it's up.

OSStatus TKAE_SendOpenApplication ();

Send open event to ticket keeper. Thiw will launch ticket keeper, and it will display its self-dismissing notification if there's a problem.

OSStatus TKAE_SendOpenApplicationNoNotification ();

Send open event to Ticket Keeper. This will launch Ticket Keeper, and it will not display its notification if there's a problem. It will stay running.

OSStatus TKAE_SendOpenApplicationNoNotificationFSSpec (FSSpec *inTKFileSpec);

Send open event to the copy of Ticket Keeper specified in inTKFileSpec. This will launch Ticket Keeper, and it will not display its notification if there's a problem. It will stay running.

OSStatus TKAE_SendGetStatus (OSErr* outStatus);

Get status from Ticket Keeper

Boolean IsTicketKeeperRunning (ProcessSerialNumber *outPSN);

Return true if TK is running, and fills out outPSN if the pointer is non-null.

Return false if TK is not running, and outPSN is unchanged.

Boolean FindTicketKeeperInExtensions(FSSpec *tkSpec);

Searches the startup volume for copies of Ticket Keeper and checks to see if any of them are in the Extensions Folder. If it finds one, returns true and fills out *tkSpec. If it doesn't find one or an error occurs, returns false and *tkSpec is unchanged.

If the hard drive catalog changes during the search, continues anyway.

Uses functions from MoreFiles.

Boolean TKAE_FindTargetTicketKeeper(FSSpec *tkSpec);

Searches the startup volume to find the Ticket Keeper that would receive AppleEvents if any of the TicketKeeperLib functions that send AEs were called. First checks to see if TK is running, and returns the FSSpec of that one if it is. Next looks in the Extensions Folder. Finally it searches the drive for a copy.

If a Ticket Keeper is found, returns true and fills out *tkSpec. If it doesn't find one or an error occurs, returns false and *tkSpec is unchanged.

If the hard drive catalog changes during the search, continues anyway.

Questions or comments? Send mail to macdev@mit.edu
Last updated on $Date: 2003/11/19 20:46:52 $
Last modified by $Author: smcguire $