WORD appl_search(WORD mode, char* fname, WORD* type, WORD* ap_id)

Description:  provides a method of identifying all of the currently running processes.

Opcode:  18  (0x0012)

Availability:  Available when appl_getinfo() indicates its presence.

Parameters:  
    mode specifies the search mode. 

    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.

    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:  returns 0 if no more applications exist or 1 when more processes exist that meet the search criteria.

Definition:
    mode specifies the search mode as follows: 
     - 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: 
     - APP_SYSTEM (0x01) system process
    - APP_APPLICATION (0x02) application
    - APP_ACCESSORY (0x04) accessory
    - APP_SHELL (0x08) desktop 
     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.


mailto: dom
HTTP: http://www-rocq.inria.fr/~bereziat


See Also: Nothing


Thanks for your GEMTOS visit!!!

(C) 2000 Gemtos.free.fr. All rights reserved by the authors.