Funzione GetExitCodeProcess (processthreadsapi.h)
Recupera lo stato di terminazione del processo specificato.
Sintassi
BOOL GetExitCodeProcess(
[in] HANDLE hProcess,
[out] LPDWORD lpExitCode
);
Parametri
[in] hProcess
Handle per il processo.
L'handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION o PROCESS_QUERY_LIMITED_INFORMATION . Per altre informazioni, vedere Sicurezza dei processi e diritti di accesso.
Windows Server 2003 e Windows XP: L'handle deve avere il diritto di accesso PROCESS_QUERY_INFORMATION .
[out] lpExitCode
Puntatore a una variabile per ricevere lo stato di terminazione del processo. Per altre informazioni, vedere la sezione Osservazioni.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
Questa funzione restituisce immediatamente. Se il processo non è terminato e la funzione ha esito positivo, lo stato restituito è STILL_ACTIVE (una macro per STATUS_PENDING (minwinbase.h)). Se il processo è terminato e la funzione ha esito positivo, lo stato restituito è uno dei valori seguenti:
- Valore di uscita specificato nella funzione ExitProcess o TerminateProcess .
- Valore restituito dalla funzione main o WinMain del processo.
- Valore dell'eccezione per un'eccezione non gestita che ha causato l'interruzione del processo.
Importante
La funzione GetExitCodeProcess restituisce un codice di errore valido definito dall'applicazione solo dopo il termine del thread. Pertanto, un'applicazione non deve usare STILL_ACTIVE (259) come codice di errore (STILL_ACTIVE è una macro per STATUS_PENDING (minwinbase.h)). Se un thread restituisce STILL_ACTIVE (259) come codice di errore, le applicazioni che testano tale valore potrebbero interpretarlo per indicare che il thread è ancora in esecuzione e continuare a verificare il completamento del thread dopo che il thread è terminato, che potrebbe inserire l'applicazione in un ciclo infinito.
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | processthreadsapi.h (include Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2, Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |