GetExitCodeProcess, fonction (processthreadsapi.h)

Article
03/01/2024

Récupère le status d’arrêt du processus spécifié.

Syntaxe

BOOL GetExitCodeProcess(
  [in]  HANDLE  hProcess,
  [out] LPDWORD lpExitCode
);

Paramètres

[in] hProcess

Handle du processus.

Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION . Pour plus d’informations, consultez Droits d’accès et de sécurité des processus.

Windows Server 2003 et Windows XP : Le handle doit avoir le droit d’accès PROCESS_QUERY_INFORMATION .

[out] lpExitCode

Pointeur vers une variable pour recevoir le status d’arrêt du processus. Pour plus d'informations, consultez la section Notes.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction retourne immédiatement. Si le processus n’est pas terminé et que la fonction réussit, le status retourné est STILL_ACTIVE (macro pour STATUS_PENDING (minwinbase.h)). Si le processus s’est terminé et que la fonction réussit, la status retournée est l’une des valeurs suivantes :

Valeur de sortie spécifiée dans la fonction ExitProcess ou TerminateProcess .
Valeur de retour de la fonction main ou WinMain du processus.
Valeur d’exception pour une exception non gérée qui a provoqué l’arrêt du processus.

Important

La fonction GetExitCodeProcess retourne un code d’erreur valide défini par l’application uniquement après l’arrêt du thread. Par conséquent, une application ne doit pas utiliser STILL_ACTIVE (259) comme code d’erreur (STILL_ACTIVE est une macro pour STATUS_PENDING (minwinbase.h)). Si un thread retourne STILL_ACTIVE (259) en tant que code d’erreur, les applications qui testent cette valeur peuvent l’interpréter comme signifiant que le thread est toujours en cours d’exécution et continuer à tester l’achèvement du thread une fois le thread terminé, ce qui peut placer l’application dans une boucle infinie.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	processthreadsapi.h (inclure Windows.h sur Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll