DosKillProcess |
DOS : Tuer un processus |
|---|---|
| DOSCALLS.DLL | os2.h |
Syntaxe
| APIRET DosKillProcess( ULONG ulAction, PID pid ); |
Paramètres
| Nom | Description | ||
|---|---|---|---|
| ulAction | Ce paramètre permet d'indiquer le mode de terminaison d'un processus : | ||
| Constante | Valeur | Description | |
| DKP_PROCESSTREE | 0 | Cette valeur permet d'indiquer qu'il faut tuer le processus et tous ses descendants. | |
| DKP_PROCES | 1 | Cette valeur permet d'indiquer que faut tuer uniquement se processus sans ses descendants. | |
| pid | Ce paramètre permet d'indiquer l'identificateur de processus à tuer. | ||
Retour
| Valeur | Constante | Description |
|---|---|---|
| 0 | NO_ERROR | Cette valeur permet d'indiquer que l'opération s'est correctement effectué |
| 13 | ERROR_INVALID_DATA | Cette valeur permet d'indiquer qu'une erreur de données invalides s'est produite. |
| 217 | ERROR_ZOMBIE_PROCESS | Cette valeur permet d'indiquer qu'une erreur de processus en état zombie. |
| 303 | ERROR_INVALID_PROCID | Cette valeur permet d'indiquer un identificateur de procédure invalide. |
| 305 | ERROR_NOT_DESCENDANT | Cette valeur permet d'indiquer erreur non descendante. |
Description
Cette fonction permet de tuer un processus à l'aide de son identificateur de processus.
Exemple
Voici un simple exemple montrant comme appeler cette API avec WatCom C++ for OS/2 :
- #define INCL_DOSERRORS
- #define INCL_DOSPROCESS
- #include "os2.h"
- #include "stdio.h"
-
- void main(void) {
- RESULTCODES ReturnCodes;
- switch(DosKillProcess(DKP_PROCESS,ReturnCodes.codeTerminate)) {
- case NO_ERROR: printf("Tout va bien !");break;
- case ERROR_INVALID_DATA: printf("Erreur : Une erreur de données invalides s'est produite.");break;
- case ERROR_ZOMBIE_PROCESS: printf("Erreur : Une erreur de processus en état zombie.");break;
- case ERROR_INVALID_PROCID: printf("Erreur : Un identificateur de procédure invalide.");break;
- case ERROR_NOT_DESCENDANT: printf("Erreur : Erreur non descendante.");break;
- }
- }
Voir également
Langage de programmation - C pour OS/2 - DosExecPgm
Langage de programmation - C pour OS/2 - DosWaitChild
Langage de programmation - C pour OS/2 - DosExit
Langage de programmation - C pour OS/2 - DosStartSession
Système d'exploitation - OS/2 - Introduction
Dernière mise à jour : Lundi, le 19 juillet 2010