Funzione TerminateJobObject (jobapi2.h)

  • Articolo

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

Vedere anche

CreateJobObject

Oggetti processo

OpenJobObject

Funzioni di processi e thread

TerminateProcess