DosQueryAppType |
DOS : Requête de type d'application |
|---|---|
| DOSCALLS.DLL | os2.h |
Syntaxe
| APIRET DosQueryAppType(PSZ pszName, PULONG pFlags); |
Paramètres
| Nom | Description | |
|---|---|---|
| pszName | Ce paramètre permet d'indiquer une chaîne de caractères ASCIIZ contenant le nom de fichier du fichier exécutable pour lequel les drapeaux doivent être renvoyés. Si la chaîne de caractères semble être un chemin d'accès complet (c'est-à-dire qu'elle contient un «:» à la deuxième position, ou qu'elle contient un «\», ou les deux), le fichier se trouve dans le répertoire de l'unité de disque disque:répertoire spécifié. Si aucun de ces éléments n'est vrai et que ce nom de fichier ne se trouve pas dans le répertoire en cours, chaque spécification d'unité de disque et de répertoire disque:répertoire dans le chemin défini dans l'environnement du programme actuel est recherchée pour ce fichier. Notez que toute extension (.xxx) est acceptable pour le nom de fichier exécutable. Si aucune extension n'est spécifiée, une extension par défaut «.exe» est utilisée. | |
| pFlags | Ce paramètre permet d'indiquer un mot double contenant des drapeaux indiquant le type d'application, comme déterminé en lisant l'entête du fichier exécutable spécifié par pszName. Notez que la séquence d'appel passe un pointeur vers un emplacement dans la mémoire d'application pour renvoyer les indicateurs de type d'application. Le paramètre pFlags est défini comme suit : | |
| Bit | Description | |
| 2 à 0 | Ce bits permettent d'indiquer le type d'application spécifié dans l'entête : 000 FAPPTYP_NOTSPEC (0x00000000) Le type d'application n'est pas spécifié dans l'en-tête exécutable. 001 FAPPTYP_NOTWINDOWCOMPAT (0x00000001) Le type d'application n'est pas compatible avec les fenêtres. 010 FAPPTYP_WINDOWCOMPAT (0x00000002) Le type d'application est compatible avec les fenêtres. 011 FAPPTYP_WINDOWAPI (0x00000003) Le type d'application est une API en fenêtre du Presentation Manager. |
|
| 3 | FAPPTYP_BOUND (0x00000008) Ce bit est défini sur 1 si le fichier exécutable a été «lié» (par la commande BIND) en tant qu'application API familiale. Les bits 0, 1 et 2 s'appliquent toujours. |
|
| 4 | FAPPTYP_DLL (0x00000010) Ce bit est défini sur 1 si le fichier exécutable est un module de bibliothèque de liens dynamiques (DLL). Les bits 0, 1, 2, 3 et 5 seront définis sur 0. |
|
| 5 | FAPPTYP_DOS (0x00000020) Ce bit est défini sur 1 si le fichier exécutable est au format PC/DOS. Les bits 0, 1, 2, 3 et 4 seront définis sur 0. |
|
| 6 | FAPPTYP_PHYSDRV (0x00000040) Ce bit est défini sur 1 si le fichier exécutable est un pilote de périphérique physique. |
|
| 7 | FAPPTYP_VIRTDRV (0x00000080) Ce bit est défini sur 1 si le fichier exécutable est un pilote de périphérique virtuel. |
|
| 8 | FAPPTYP_PROTDLL (0x00000100) Ce bit est défini sur 1 si le fichier exécutable est un module de bibliothèque de liens dynamiques à mémoire protégée. |
|
| 9 à 13 | Ces bits sont réservés. | |
| 14 | FAPPTYP_32BIT (0x00004000) Ce bit défini sur 1 pour les fichiers exécutables 32 bits. |
|
| 15 | Ce bit est réservé. | |
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 2 | ERROR_FILE_NOT_FOUND | Cette valeur permet d'indiquer qu'une erreur de fichier introuvable s'est produite. |
| 3 | ERROR_PATH_NOT_FOUND | Cette valeur permet d'indiquer qu'une erreur de chemin introuvable s'est produite. |
| 4 | ERROR_TOO_MANY_OPEN_FILES | Cette valeur permet d'indiquer qu'une erreur de trop de fichier ouvert simultanément s'est produite. |
| 11 | ERROR_BAD_FORMAT | Cette valeur permet d'indiquer qu'une erreur de mauvais format s'est produite. |
| 15 | ERROR_INVALID_DRIVE | Cette valeur permet d'indiquer que l'unité de disque est invalide. |
| 32 | ERROR_SHARING_VIOLATION | Cette valeur permet d'indiquer qu'une erreur de violation de partage s'est produite. |
| 108 | ERROR_DRIVE_LOCKED | Cette valeur permet d'indiquer qu'une erreur d'unité verrouillé s'est produite. |
| 110 | ERROR_OPEN_FAILED | Cette valeur permet d'indiquer un échec d'ouverture de fichier ou de périphérique. |
| 191 | ERROR_INVALID_EXE_SIGNATURE | Cette valeur permet d'indiquer une signature d'exécutable invalide. |
| 192 | ERROR_EXE_MARKED_INVALID | Cette valeur permet d'indiquer une erreur de marque d'exécutable invalide s'est produite. |
Description
Cette fonction permet de retourner le type d'application d'un fichier exécutable.
Remarques
- La fonction DosQueryAppType renvoie le type d'application d'un fichier exécutable.
- La composante Presentation Manager utilise cette fonction pour déterminer le type d'application en cours d'exécution.
- Le type d'application est déterminé par les options utilisées dans le fichier de définitions de module (.DEF).
- Cette fonction est utile pour déterminer s'il existe des exécutables, des DLL et des pilotes de périphérique et s'ils sont en cours d'exécution. Les exécutables ayant des erreurs ou une corruption de l'éditeur de liens ne sont pas en état d'exécution.
Voir également
Langage de programmation - C pour OS/2 - DosLoadModule
Langage de programmation - C pour OS/2 - DosQueryProcType
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010