Syntaxe
BOOL GetExitCodeProcess( HANDLE hProcess, LPDWORD lpExitCode);
|
Paramètres
Nom |
Description |
hProcess |
Ce paramètre permet d'indiquer l'identificateur du processus. |
lpExitCode |
Ce paramètre permet d'indiquer un pointeur vers une variable d'état de terminaison de processus. |
Retour
Valeur |
Description |
FALSE |
Cette valeur permet d'indiquer qu'une erreur s'est produite, dans ce cas il faudra consulter la fonction GetLastError. |
TRUE |
Ces valeurs permettent d'indiquer que l'opération s'est correctement effectués. |
Description
Cette fonction permet de demander le code d'état de terminaison d'un processus spécifié.
Remarques
- La fonction GetExitCodeProcess retourne immédiatement et par conséquent, si le processus n'est pas terminé et que la fonction est réussit,
l'état renvoyé est STILL_ACTIVE, sinon si le processus est terminé et que la fonction réussit, alors l'état est renvoyé avec l'une des
valeurs suivantes : Une valeur de sortie spécifié par la fonction ExitProcess ou TerminateProcess, la valeur de retour de
la fonction principale ou de la fonction WinMain du processus, ou encore la valeur d'exception pour une exception non gérée entraînant
l'arrêt du processus.
- La fonction GetExitCodeProcess retourne un code d'erreur valide définit par l'application seulement après la fin du processus léger.
Ainsi, une application ne doit pas utiliser STILL_ACTIVE avec le code d'erreur 259. Si un processus léger retourne un code d'erreur 259
(STILL_ACTIVE), alors l'application testant cette valeur pourraient interpréter cette valeur comme un processus léger toujours en
cours d'exécution et continuer de tester l'achèvement du processus léger après que le fin du processus léger se soit produite, et par le fait
même rester dans une boucle infinie.
Voir également
Langage de programmation - Structure de contrôle - Programmation multitâche
Dernière mise à jour : Mercredi, le 6 août 2014