Funzione TerminateJobObject (jobapi2.h)
Termina tutti i processi attualmente associati al processo. Se il processo è annidato, questa funzione termina tutti i processi attualmente associati al processo e tutti i relativi processi figlio nella gerarchia.
Sintassi
BOOL TerminateJobObject(
[in] HANDLE hJob,
[in] UINT uExitCode
);
Parametri
[in] hJob
Handle per il processo i cui processi verranno terminati. La funzione CreateJobObject o OpenJobObject restituisce questo handle. Questo handle deve avere il diritto di accesso JOB_OBJECT_TERMINATE. Per altre informazioni, vedere Sicurezza oggetti processo e diritti di accesso.
L'handle per ogni processo nell'oggetto processo deve avere il diritto di accesso PROCESS_TERMINATE. Per altre informazioni, vedere Elaborare diritti di sicurezza e accesso.
[in] uExitCode
Codice di uscita da usare da tutti i processi e i thread nell'oggetto processo. Usare la funzione GetExitCodeProcess per recuperare il valore di uscita di ogni processo. Usare la funzione GetExitCodeThread per recuperare il valore di uscita di ogni thread.
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
Non è possibile che nessuno dei processi associati al processo rinvii o gestisca la terminazione. È come se TerminaProcess fosse chiamato per ogni processo associato al processo.
La terminazione di un processo annidato termina inoltre tutti gli oggetti del processo figlio. Le risorse usate dai processi terminati vengono addebitate alla catena di processi padre nella gerarchia.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versioni successive. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | jobapi2.h (includere Windows.h, Jobapi2.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |