Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.3.19  x_appl_term                                                TOS

 Name:         »Terminate application« - Terminate an application and 
               remove it from memory (Geneva).

 Opcode:       28931

 Syntax:       int16_t x_appl_term( int16_t apid, int16_t retrn, 
               int16_t set_me );

 Description:  The call x_appl_term will cause an application to 
               terminate. It is similar to shel_write mode 4, except 
               that it allows for just one application to be 
               terminated.

                  . apid is the application ID of the application to 
                    be terminated.
                  . retrn is a value which is returned to the program 
                    which launched the application; this should 
                    usually correspond to a GEMDOS error number, or 0 
                    for no error.
                  . The set_me parameter must always be non-zero.

               If the application to be terminated does not recognize 
               the AP_TERM message, the user will first be presented 
               with an alert box confirming that he wants to 
               terminate.

 Return value: 0: The application was not found

 Availability: The function is available only under Geneva.

 Group:        Application library

 See Also:     Binding