Функция IsProcessInJob (jobapi.h)

  • Статья

Определяет, выполняется ли процесс в указанном задании.

Синтаксис

BOOL IsProcessInJob(
  [in]           HANDLE ProcessHandle,
  [in, optional] HANDLE JobHandle,
  [out]          PBOOL  Result
);

Параметры

[in] ProcessHandle

Дескриптор проверяемого процесса. Дескриптор должен иметь право доступа PROCESS_QUERY_INFORMATION или PROCESS_QUERY_LIMITED_INFORMATION. Дополнительные сведения см. в разделе Обработка прав на безопасность и доступ.

Windows Server 2003 и Windows XP: Дескриптор должен иметь право доступа к PROCESS_QUERY_INFORMATION.

[in, optional] JobHandle

Дескриптор задания. Если этот параметр имеет значение NULL, функция проверяет, выполняется ли процесс под каким-либо заданием.

Если этот параметр не имеет значение NULL, дескриптор должен иметь право доступа JOB_OBJECT_QUERY. Дополнительные сведения см. в разделе Безопасность объекта задания и права доступа.

[out] Result

Указатель на значение, которое получает значение TRUE, если процесс выполняется в задании, и FALSE в противном случае.

Возвращаемое значение

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Приложение не может получить дескриптор объекта задания, в котором оно выполняется, если у него нет имени объекта задания. Однако приложение может вызывать функцию QueryInformationJobObject со значением NULL для получения сведений об объекте задания.

Чтобы скомпилировать приложение, использующее эту функцию, определите _WIN32_WINNT как 0x0501 или более поздней версии. Дополнительные сведения см. в разделе Использование заголовков Windows.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header jobapi.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

AssignProcessToJobObject

Объекты заданий

Функции процессов и потоков

QueryInformationJobObject