Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-FileApplication Services Library
appl_search()                                                           AES

Syntax

WORD appl_search( mode, fname, type, ap_id )
WORD mode;
CHAR *fname;
WORD *type,*ap_id;

Function       appl_search() provides a method of identifying all of the
               currently running processes.

Opcode         18 (0x12)

Availability   Available only in AES versions 4.0 and above when
               appl_getinfo() indicates its presence.

Parameters     mode specifies the search mode as follows:

               Name      mode  Meaning

               APP_FIRST  0    Return the filename of the first
                               process

               APP_NEXT   1    Return the filename of subsequent
                               processes

               fname should point to a memory location at least 9 bytes
               long to hold the 8 character process filename found and
               the NULL byte.
               type is a pointer to a WORD into which will be
               placed the process type as follows:

               Name              type   Meaning

               APP_SYSTEM        0x01   System process

               APP_APPLICATION   0x02   Application

               APP_ACCESSORY     0x04   Accessory

               APP_SHELL         0x08

               The type parameter is actually a bit mask so it is possible
               that a process containing more than one characteristic will
               appear. The currently running shell process (usually the
               desktop) will return a value of APP_APPLICATION | APP_SHELL
               (0x0A).
               ap_id is a pointer to a word into which will be placed the
               processes' application identifier.

Binding        intin[0] = mode;

               addrin[0] = fname;
               addrin[1] = type;
               addrin[2] = ap_id;

               return crys_if(0x12);

Return Value   appl_search() returns 0 if no more applications exist or 1
               when more processes exist that meet the search criteria.

Group          Application Services Library