appl_find

Syntaxe

Paramètres

Description

Cette fonction permet de rechercher l'identificateur d'application d'une autre application dans le système.

Remarques

• L'appel appl_find permet d'obtenir l'identifiant d'une autre application exécutée en parallèle.
• Le nom doit impérativement comporter huit caractères; s'il est plus court, il doit être complété par des espaces. La chaîne de caractères doit se terminer par un pointeur NULL. Dans MagiC et AES versions 4.0 et supérieures, il est également possible d'obtenir l'identifiant de l'application courante en passant un pointeur NULL. Il est également possible de recalculer l'identifiant AES d'une application en identifiant MiNT, et inversement. Pour ce faire, procédez comme suit :

Mot de poids fort	Signification de ap_fpname
-1	La fonction attend l'identifiant MiNT d'une application dans le mot de poids faible et renvoie l'identifiant AES de cette application après l'appel.
-2	La fonction attend l'identifiant AES d'une application dans le mot de poids faible et renvoie l'identifiant MiNT de cette application après l'appel.
-3	L'identifiant AES de l'application surchargée est renvoyé. Le mot de poids faible n'a aucun effet ici et peut être égal à 0. Cette option est uniquement disponible sous MyAES (depuis la version 0.94a), N.AES et XaAE.



• La fonction ne fonctionne correctement que si le programme concerné a été lancé avec shel_write. Il est également important de noter que cette fonction ne permet pas de trouver les processus légers.
• Pour KAOS 1.4.2 et MagiC, il est également possible d'obtenir le nom d'une application en passant la chaîne de caractères «?\0\n», où «n» représente l'ap_id. Si la valeur de la fonction renvoie 0, l'ap_id est invalide. Sinon, la valeur renvoyée est 1 et la chaîne sera écrasée par le nom de l'application. Si deux applications portent le même nom, seule la première sera trouvée. Certains noms AES sont prédéfinis :

Nom	Description
"SCRENMGR"	Gestionnaire d'écran
"        "	Bureau intégré
"?AGI"	appl_getinfo avec des versions AES < 4.00 est présent.