Funzione IsProcessInJob (jobapi.h)
Determina se il processo è in esecuzione nel processo specificato.
Sintassi
BOOL IsProcessInJob(
[in] HANDLE ProcessHandle,
[in, optional] HANDLE JobHandle,
[out] PBOOL Result
);
Parametri
[in] ProcessHandle
Handle per il processo da testare. 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.
[in, optional] JobHandle
Handle per il processo. Se questo parametro è NULL, la funzione verifica se il processo è in esecuzione in qualsiasi processo.
Se questo parametro non è NULL, l'handle deve disporre del diritto di accesso JOB_OBJECT_QUERY. Per altre informazioni, vedere Job Object Security and Access Rights.For more information, see Job Object Security and Access Rights.
[out] Result
Puntatore a un valore che riceve TRUE se il processo è in esecuzione nel processo e FALSE in caso contrario.
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
Un'applicazione non può ottenere un handle per l'oggetto processo in cui è in esecuzione, a meno che non abbia il nome dell'oggetto processo. Tuttavia, un'applicazione può chiamare la funzione QueryInformationJobObject con NULL per ottenere informazioni sull'oggetto processo.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0501 o versione successiva. 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 | jobapi.h |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |