Função IsProcessInJob (jobapi.h)
Determina se o processo está em execução no trabalho especificado.
Sintaxe
BOOL IsProcessInJob(
[in] HANDLE ProcessHandle,
[in, optional] HANDLE JobHandle,
[out] PBOOL Result
);
Parâmetros
[in] ProcessHandle
Um identificador para o processo a ser testado. O identificador deve ter o acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.
Windows Server 2003 e Windows XP: O identificador deve ter o acesso de PROCESS_QUERY_INFORMATION correto.
[in, optional] JobHandle
Um identificador para o trabalho. Se esse parâmetro for NULL, a função testará se o processo está em execução em qualquer trabalho.
Se esse parâmetro não for NULL, o identificador deverá ter o JOB_OBJECT_QUERY direito de acesso. Para obter mais informações, consulte Segurança do objeto de trabalho e direitos de acesso.
[out] Result
Um ponteiro para um valor que recebe TRUE se o processo estiver em execução no trabalho e FALSE caso contrário.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Um aplicativo não pode obter um identificador para o objeto de trabalho no qual está em execução, a menos que tenha o nome do objeto de trabalho. No entanto, um aplicativo pode chamar a função QueryInformationJobObject com NULL para obter informações sobre o objeto de trabalho.
Para compilar um aplicativo que usa essa função, defina _WIN32_WINNT como 0x0501 ou posterior. Para obter mais informações, consulte Usando os cabeçalhos do Windows.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | jobapi.h |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |