Funzione IsProcessInJob (jobapi.h)

  • Articolo

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

Vedere anche

AssignProcessToJobObject

Oggetti processo

Funzioni di processi e thread

QueryInformationJobObject