|
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.
|