Section courante

A propos

Section administrative du site

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 :

  1. #define INCL_DOSERRORS
  2. #define INCL_DOSPROCESS
  3. #include "os2.h"
  4. #include "stdio.h"
  5.  
  6. void main(void) {
  7.      RESULTCODES ReturnCodes;
  8.      switch(DosKillProcess(DKP_PROCESS,ReturnCodes.codeTerminate)) {
  9.         case NO_ERROR: printf("Tout va bien !");break;
  10.         case ERROR_INVALID_DATA: printf("Erreur : Une erreur de données invalides s'est produite.");break;
  11.         case ERROR_ZOMBIE_PROCESS: printf("Erreur : Une erreur de processus en état zombie.");break;
  12.         case ERROR_INVALID_PROCID: printf("Erreur : Un identificateur de procédure invalide.");break;
  13.         case ERROR_NOT_DESCENDANT: printf("Erreur : Erreur non descendante.");break;
  14.      }
  15. }

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