Share via

Função IsProcessInJob (jobapi.h)

  • Artigo

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

Confira também

AssignProcessToJobObject

Objetos de trabalho

Funções de thread e processo

QueryInformationJobObject